strumento di supporto reStructuredText
-
02-10-2019 - |
Domanda
Sono un grande fan di reStructuredText , tuttavia gli strumenti che lo sostengono sono sparsi in tutto la rete. Il lista strumento ufficiale è incompleta e / o obsolete, e può essere aggiornato solo tramite impegnarsi privilegi. Per qualche tempo c'era una lista completa presso il Wikipedia reStructuredText pagina , ma questo apparentemente " non soddisfano le linee guida per i contenuti web notability "e è stato rimosso .
Quindi, per dirla in una forma di domanda: Quali strumenti di supporto si può aspettare di trovare quando si lavora con reStructuredText, per esempio editor di testo, software Wiki, convertitori da e per reStructuredText ecc.?
Soluzione
Recupero (ed estendendo) l'elenco da un vecchia versione del Wikipedia pagina :
Documentazione
Implementazioni
Anche se l'implementazione di riferimento di reStructuredText è scritto in Python, ci sono parser reStructuredText in altre lingue.
Python - Docutils
La distribuzione principale reStructuredText è la href="http://docutils.sourceforge.net/" rel="nofollow noreferrer"> pacchetto . Esso contiene diversi strumenti di conversione:
- rst2html - da reStructuredText a HTML
- rst2xml - da reStructuredText a XML
- rst2latex - da reStructuredText a LaTeX
- rst2odt -. Da reStructuredText a ODF Text (word processor) documento
- rst2s5 - da reStructuredText a S5 , un semplice Presentazione basata su standard del sistema di esposizione
- rst2man - da reStructuredText a pagina man
Haskell - Pandoc
Pandoc è una libreria Haskell per la conversione da un formato ad un altro markup, e uno strumento da riga di comando che utilizza questa libreria. Può leggere Markdown e (sottoinsiemi di) reStructuredText, HTML e LaTeX, e può scrivere Markdown, reStructuredText, HTML, LaTeX, il contesto, PDF, RTF, DocBook XML, OpenDocument XML, ODT, GNU Texinfo, MediaWiki markup, groff uomo pagine e presentazioni S5 HTML.
C'è un Pandoc strumento online (POT) per provare questa libreria. Purtroppo, rispetto alla reStructuredText linea renderer (ROR),
- POT tronca ingresso un po 'più breve. L'utente deve rendere POT ingresso in blocchi che possono essere rese integralmente dai ROR.
- uscita POT manca i messaggi di errore utile visualizzati dal ROR (e generati da
docutils
)
Java - JRST
JRST è un parser Java reStructuredText. Attualmente può output HTML, XHTML, DocBook xdoc e PDF, ma sembra avere seri problemi: né PDF o (X) HTML generazione funziona utilizzando la corrente di download completo, pagine dei risultati di (X) HTML sono vuote e la generazione di PDF non riesce a IO problemi con i file XSL (non in bundle ??). Si noti che il JRST originale è stato rimosso dal sito web; una forcella è trovato su GitHub .
Scala - Laika
Laika è una nuova libreria per la trasformazione linguaggi di markup per altri formati di output. Attualmente supporta input da Markdown e reStructuredText e l'uscita dei prodotti HTML. La biblioteca è scritto in Scala, ma dovrebbe essere utilizzabile anche da Java.
Perl
- Text :: ristrutturate - implementazione Perl di reStructuredText parser
- Dotiac: : DTL :: :: Addon markup - filtri per il lavoro con il linguaggio di markup comunes - Supporto reStructuredText
- pod :: :: Leggi POM :: ristrutturate - View per pod :: POM che le uscite reStructuredText
PHP
- Gregwar / RST - un maturo parser PHP5.3 con i test
- php-reStructuredText - Un semplice, incompleto (ma funzionale) attuazione
C # /. NET
- reStructuredText per ANTLR - A C # base di parser con le prove (in corso). Fornisce inoltre il server lingua dietro reStructuredText estensione per Visual Studio Codice .
Nim / C
Il Nim compilatore include i comandi rst2html
and rst2tex
che trasformano i file reStructuredText in file HTML e TeX. La libreria standard fornisce i seguenti moduli (utilizzati dal compilatore) per gestire i file reStructuredText di programmazione:
- primo - implementa un parser reStructuredText
- rstast - implementa un AST per il parser reStructuredText
- rstgen - implementa un generatore di HTML / Latex da reStructuredText
Altri 3rd party convertitori
La maggior parte (ma non tutti) di questi strumenti si basano su Docutils (vedi sopra) e fornire la conversione da o verso formati che potrebbero non essere supportati dalla distribuzione principale.
Da reStructuredText
- restview - Questo pacchetto python
pip
installabile richiededocutils
, che fa il rendering vero e proprio. caratteristica principale direstview
la facilità d'uso è che, quando si salvano le modifiche al documento (s), è automagicamente re-rendering e ri-display li.restview
- inizia un piccolo server web
- chiamate
docutils
per rendere il documento (s) in HTML - chiama browser del tuo dispositivo per visualizzare l'output HTML.
- rst2pdf - da reStructuredText a PDF
- rst2odp - da reStructuredText a ODF Presentazione
- rst2beamer - da reStructuredText a LaTeX Beamer classe di presentazione
- Wikir - da reStructuredText a Google (e forse altri) Wiki formati
- rst2qhc - Convertire un insieme di file in un reStructuredText Qt (toolkit) file della Guida e (opzionale) un file di Qt? Progetto
Per reStructuredText
- xml2rst è uno script XSLT per convertire Docutils rappresentazione XML interno (indietro) a reStructuredText
- Pandoc (vedi sopra) può anche convertire da Markdown, HTML e LaTeX per reStructuredText
- db2rst è un semplice e limitata DocBook a reStructuredText traduttore
- pod2rst - convertito. file Pod to file reStructuredText
Estensioni
Alcuni progetti utilizzano reStructuredText come base per costruire, o fornire funzionalità extra estendere l'utilità degli strumenti reStructuredText.
Sphinx
Il href="http://sphinx.pocoo.org/" rel="nofollow noreferrer"> Sfinge generatore di documentazione
rest2web è un semplice strumento che consente di creare il vostro sito web da un singolo template (o come molti come si vuole), e mantenere il contenuto in reStructuredText. Pygments è un evidenziatore di sintassi generica per uso generale in tutti i tipi di software come i sistemi di forum, wiki o altro applicazioni che necessitano di codice sorgente Prettify. Vedere Utilizzando Pygments nei documenti reStructuredText . Mentre qualsiasi testo normale editore è adatto per scrivere documenti reStructuredText , alcuni editori hanno un miglior supporto di altri. Il Emacs supporta via prima modalità si presenta come parte dei Docutils pacchetto sotto Il pacchetto C'è un prima modalità per la Jed redattore dei programmatori. gedit, l'editor di testo ufficiale dell'ambiente desktop GNOME. C'è un gedit reStructuredText plug . Geany , un piccolo e leggero ambiente di sviluppo integrato include il supporto per reStructuredText da versione 0.12 (10 ottobre 2007) Leo , un editor che delinea per i programmatori, supporta reStructuredText tramite primo-plugin o tramite "@ auto-primo" nodi (non è ben documentato, ma @auto nodi -rst consentono la modifica dei file direttamente primi, l'analisi della struttura nel profilo Leo). Inoltre fornisce un modo per visualizzare in anteprima ilHTML risultante, in un riquadro "viewrendered". Il FTE Folding Editor di testo - un libero (rilasciato sotto licenza GNU GPL) editor di testo per gli sviluppatori.
FTE ha un modalità per il supporto reStructuredText. Fornisce colore di evidenziazione degli elementi di base e RSTX menù speciale che forniscono modo semplice per inserire elementi RSTX più popolari per un documento. PYK è un successore di PyEdit e reStInPeace, scritto in Python con l'aiuto del Qt4 toolkit. L'Eclipse IDE con la ReST Editor plug-in fornisce il supporto per la modifica dei file reStructuredText. Notex è un browser basato (general purpose) editor di testo, con gestione integrata dei progetti e l'evidenziazione della sintassi. Più esso consente di scrivere libri, relazioni, articoli, ecc utilizzando rST e convertirli in LaTex, PDF o HTML. I file PDF sono di qualità elevata pubblicazione e sono prodotti tramite Sfinge con la suite Texlive LaTex. Notepad ++ è un editor di testo general purpose per Windows. Ha l'evidenziazione della sintassi per molte lingue built-in e il supporto per reStructuredText tramite un dall'utente lingua definita per reStructuredText . codice Visual Studio è un editor di testo general purpose per Windows / MacOS / Linux. Ha l'evidenziazione della sintassi per molte lingue built-in e supporti reStructuredText tramite un'estensione da LeXtudio . Sublime Text è un editor di codice sorgente completamente personalizzabile ed estendibile disponibile per Windows, OS X e Linux. La registrazione è necessaria per l'uso a lungo termine, ma tutte le funzioni sono disponibili nella versione non registrata, con i ricordi occasionali di acquistare una licenza. Versioni 2 e 3 (attualmente in beta) sintassi sostegno reStructuredText evidenziando per default, e diversi plugin sono disponibili attraverso il pacchetto agenzia pacchetto controllo per fornire frammenti e completamento del codice, sintassi addizionale highlighting, la conversione da / RST e altri formati, e HTML in anteprima nel browser. BBEdit (e la sua variante libera TextWrangler ) per Mac può sintassi evidenziazione reStructuredText utilizzare questo modulo di linguaggio senza codice . TextMate , un general-purpose editor di testo GUI proprietaria per Mac OS X, ha una bundle per reStructuredText . Intype è un editor di testo proprietaria per Windows, che il sostegno ReStructuredText fuori dalla scatola. E è un testo di proprietà Editor rilasciato sotto la "Licenza Open Company". Supporta fasci di TextMate, quindi dovrebbe sostenere reStructuredText allo stesso modo TextMate fa. PyCharm (e altri IDE piattaforma IntelliJ?) E 'dotato Riposo / Sphinx (l'evidenziazione della sintassi, completamento automatico e l'anteprima). ) qui ci sono alcuni programmi Wiki che supportano il markup reStructuredText come la sintassi di markup nativa, o come add-on: MediaWiki reStructuredText estensione permette reStructuredText markup in MediaWiki circondato da MoinMoin è un facile da usare ed estensibile WikiEngine avanzata, con una vasta comunità di utenti. Detto in poche parole, si tratta di collaborazione sulle pagine web facilmente modificabili. C'è un reStructuredText Parser per MoinMoin . Trac è un sistema di monitoraggio e wiki problema maggiore per i progetti di sviluppo software.
C'è un reStructuredText Supporto Trac . Questo Wiki è un Webware per Python Wiki scritto da Ian Bicking. Questo wiki utilizza ReStructuredText per la sua marcatura. rstiki è un minimalista wiki personale singolo file utilizzando la sintassi reStructuredText (via docutils) ispirato pwyky . Non supporta l'indicazione dell'autore, versioning, la gerarchia, cromo / inquadratura / template o styling. Sfrutta docutils / reStructuredText come la sintassi wiki. Come tale, è meno di 200 righe di codice, e in un unico file. Lo metti in una directory e funziona. ikiwiki è un compilatore wiki. Converte pagine wiki in pagine HTML adatte per la pubblicazione su un sito web. Ikiwiki memorizza le pagine e la storia in un sistema di controllo di revisione, come Subversion o Git. Ci sono molte altre funzionalità, tra cui il supporto per il blogging, così come un grande array di plugin. E ' reStructuredText plug , tuttavia è piuttosto limitata e non è raccomandato come il suo linguaggio di markup principale in questo momento . online reStructuredText editore può essere usato per giocare con il markup e vedere i risultati immediatamente. WordPreSt reStructuredText plug-in per WordPress . (PHP) reStructuredText parser plug per Zine (diventerà obsoleto in versione 0.2, quando Zine è in programma per ottenere un supporto reStructuredText nativo). Zine è interrotto. (Python) Pelican è un blog generatore statico che supporta la scrittura di articoli a riposo. (Python) Hyde è un generatore di sito web statico che supporti riposo. (Python) acrilammide è un generatore di blog statico che supporta la scrittura di articoli a riposo. (Python) Nikola è un sito statico e blog generatore che supporta riposo. (Python) Ipsum generi è un generatore di blog statica scritto in Nim. Yozuch è un generatore di blog statica scritto in Python. rest2web
Pygments
Editor gratis
Emacs
/docutils/tools/editors/emacs/rst.el
Vim
vim-common
per che viene fornito con la maggior parte delle distribuzioni GNU / Linux ha reStructuredText evidenziazione della sintassi e il supporto di rientro reStructuredText fuori dalla scatola:
Jed
gedit
Geany
Leo
FTE
PYK
Eclipse
Notex
Notepad ++
codice Visual Studio
Editors reStructuredText dedicati
Proprietario redattori
Sublime Text
BBEdit / TextWrangler
TextMate
Intype
E Text Editor
PyCharm
Wiki
MediaWiki
<rst>
e </rst>
. MoinMoin
Trac
Questo Wiki
rstiki
ikiwiki
Web Services
Sandbox
Blogging quadri
WordPress
Zine
pellicano
Hyde
acrilammide
Nikola
ipsum generi
Yozuch
Altro