Pytania otagowane jako restructuredtext

Wiem, że reStructuredText ma tę dyrektywę: .. code:: bash gedit pohl.m który renderuje blok kodu. Czy jest jakiś sposób, aby uzyskać podświetlanie składni dla wstawionych fragmentów, takich jak ten: Do edit the file, type ``gedit pohl.m`` into a terminal. Backticks oznaczają to jako kod, ale chciałbym to podkreślić pygementami, takimi …

130 restructuredtext 

Odpowiedzi na to pytanie są wysiłkiem społeczności . Edytuj istniejące odpowiedzi, aby ulepszyć ten post. Obecnie nie przyjmuje nowych odpowiedzi ani interakcji. Jestem wielkim fanem reStructuredText , jednak narzędzia, które go obsługują, są rozproszone po całym Internecie. Oficjalna lista narzędzi jest niepełna i / lub nieaktualne i może być aktualizowana …

128 restructuredtext 

Mam projekt hostowany na GitHub. W tym celu napisałem plik README przy użyciu składni Markdown, aby ładnie go sformatować na GitHub. Ponieważ mój projekt jest w Pythonie, planuję również załadować go do PyPi . Składnia używana w plikach README w PyPi to reStructuredText. Chciałbym uniknąć konieczności obsługi dwóch plików README …

116 python  github  markdown  restructuredtext  pypi 

Jak wstawić odsyłacz na stronie reST / Sphinx do nagłówka podrzędnego lub kotwicy na innej stronie w tym samym zestawie dokumentacji?

110 python-sphinx  restructuredtext 

W obecnym stanie to pytanie nie pasuje do naszego formatu pytań i odpowiedzi. Oczekujemy, że odpowiedzi będą poparte faktami, referencjami lub ekspertyzą, ale to pytanie prawdopodobnie będzie wymagało debaty, argumentów, ankiet lub rozszerzonej dyskusji. Jeśli uważasz, że to pytanie można poprawić i prawdopodobnie ponownie otworzyć, odwiedź centrum pomocy, aby uzyskać …

90 documentation  markdown  markup  restructuredtext  textile 

Próbuję utworzyć poprawnie zagnieżdżoną listę przy użyciu następującego kodu (następujące dokumenty Sphinx i docutils ): 1. X a. U b. V c. W 2. Y 3. Z Spodziewam się, że spowoduje to dwa OLs, ale zamiast tego otrzymuję następujące dane wyjściowe: <ol class="arabic simple"> <li>X</li> </ol> <blockquote> <div> <ol class="loweralpha …

90 markup  restructuredtext  python-sphinx 

Oto, co chciałbym zrobić: 1. `link <http://www.google.com>`__ 2. `link <http://www.yahoo.com>`__ Pozyskać: <ol> <li><a href="http://www.google.com">link</a></li> <li><a href="http://www.yahoo.com">link</a></li> </ol> Kontekstem jest lista publikacji, gdzie chcę, aby wszystkie miały na końcu link oznaczony „DOI”. Jednak wydaje się, że zawodzi to w przypadku: <string>:3: (WARNING/2) Duplicate explicit target name: "doi". Dokładny błąd wydaje się …

82 python  restructuredtext 

Jak formatujesz tekst w oznaczonym linku w reStructuredText? W szczególności chciałbym najpierw wygenerować następujący kod HTML: <a href="http://docs.python.org/library/optparse.html"><tt>optparse.OptionParser</tt> documentation documentation</a> Wynik powinien wyglądać następująco: optparse.OptionParser dokumentacja gdzie część „optparse.OptionParser” jest zapisana czcionką o stałej szerokości. próbowałem ```optparse.OptionParser`` <http://docs.python.org/library/optparse.html>`_ jednak to dało <tt class="docutils literal">`optparse.OptionParser</tt> documentation <<a class="reference external" href="http://docs.python.org/library/optparse.html">http://docs.python.org/library/optparse.html</a>>`_ który …

82 python-sphinx  restructuredtext