Articles of restructunetworkingtext

Proyecto de formatting svn y rST

Tengo algunos problemas al enviar un file rST como ===== TÍTULO ===== Capítulo ======= Sección ——- bla bla bla Tengo este error: Transmisión de datos de file .svn: error confirmado (detalles a continuación): svn: Commit bloqueado por pre-commit hook (código de salida 1) con salida: Algunas partes de tu compromiso parecen sospechosamente fusionarse marcadores de […]

reStructunetworkingText crea hyperlinks a files fuente (C, configuraciones, …) trabajando en GitHub y Read the Docs

Me gustaría crear un documento reStructunetworkingText que proporcione un hyperlink a un file fuente C o un file de configuration del SO alojado en GitHub en el mismo repository que la documentation. El enlace debería conectarse tanto en GitHub (señalando un file en el mismo repository) como en Leer los documentos (preferiblemente apuntando a GitHub). […]

¿Es posible conciliar github y docutils buildhtml?

Github analizará un file reStructunetworkingText si su extensión es .rst . Los docutils buildhtml.py solo analizarán los files con la extensión .txt , y no puedo ver una opción para cambiar eso. Esto es masivamente molesto. ¿Hay alguna manera de hacer que Github reconozca los files .txt como RST o buildhtml para reconocer los primeros […]

¿Puedo "arreglar" los niveles de encabezado en rST en GitHub?

En GitHub, en un file .md puedo especificar los niveles de encabezado que se respetan en la forma en que se muestran allí, pero mis files .rst no son: el encabezado de nivel "más alto" se trata como un encabezado de nivel 1, Por ejemplo, ## Heading Stuff ## Sub-heading More stuff en un .md […]

Las tablas de text reestructuradas NO se representan con rayas de cebra en github

¿Hay alguna manera de configurar las tablas de text reestructurado para que no se procesen con rayas de cebra? Aquí hay un ejemplo de una celda en mi table: +———————————–+————————————-+ | How are we going to get the user? | The user will be entenetworking in a form | | | | | | “src/app/home/home.tpl.html“ […]

Texto reestructurado: retrocede si falta el module doctest

Parece que Github no admite la syntax sphinx.ext.doctest en su procesador reStructunetworkingText, que está causando algunos problemas al intentar include un bloque de código de estilo .. doctest ( .. doctest ) en un README.rst que se transcribe a la documentation índice (que es renderizado por sphinx). Si reemploop la directiva .. doctest con otra […]

Enlaces de GitHub en documentos de Sphinx

Aquí hay un ejemplo del documento de Sphinx: https://github.com/django-tastypie/django-tastypie/blob/v0.13.2/docs/release_notes/v0.13.2.rst Me gustaría comprometer SHA's, numbers de edición y @mentions a hyperlink. De todos modos para hacer eso automáticamente?

La alignment de la image no funciona con .rst en github

Tengo una image que quiero alinear en el file README.rst en github pero dando las especificaciones: .. image:: Logo/PNG/respawn-logo.png :height: 109 px :width: 126 px :scale: 50 % :alt: respawn :align: center no funciona con la image aún en su position original y sin escalar. ¿Alguna razón por qué?

Usar references en la wiki de GitHub con text reestructurado

Estoy tratando de usar references internas para vincular un índice encima de mi página wiki con varias secciones dentro del documento. Aquí hay un ejemplo: * `My index`_ + Foreword_ + `Technical details`_ My index ——– Foreword ~~~~~~~~ Technical details ~~~~~~~~~~~~~~~~~ Si genero la página HTML a través de rest2html obtengo el resultado correcto. Sin […]

Viendo .rst dentro de un sitio "github pages"

Moveré la documentation de un proyecto de código abierto a Github Pages, pero estoy atascado en mover los primeros files. Tenemos un ReadMe.rst que puedes ver aquí en el código. Me gustaría vincular a esa página desde nuestra página principal de documentation, pero GitHub no representa el primero como HTML, por lo que el browser […]