Come aprire file .RST su Windows
Per aprire file .RST su Windows, aprire il primo file in un editor di testo (ad esempio, Blocco note) per visualizzare o modificare il reStructuredText non elaborato.
Istruzioni passo passo
- Aprire il primo file in un editor di testo (ad esempio, Blocco note) per visualizzare o modificare il reStructuredText non elaborato.
- Se hai bisogno di un output formattato, utilizza gli strumenti Docutils o Sphinx per renderizzarlo/crearlo (ad esempio, convertirlo in HTML).
Problemi comuni
Il file si apre come testo normale e sembra "non formattato"
reStructuredText è un linguaggio di markup memorizzato come testo semplice, quindi un normale editor mostrerà il markup non elaborato anziché un documento con stile.
- Aprilo in un editor di testo per leggere/modificare la fonte.
- Se desideri una vista con stile, renderizzala/convertila utilizzando Docutils o creala utilizzando Sphinx per produrre HTML (o un altro formato di output).
Facendo doppio clic non si apre il file o si apre nell'app sbagliata
Il tuo sistema potrebbe non avere un'associazione di file per .rst (o è associato a un'app che non desideri).
- Utilizza "Apri con" e scegli un editor di testo per visualizzarlo.
- Facoltativamente, modifica l'associazione predefinita dell'app per .rst con il tuo editor preferito.
Il rendering/creazione non riesce a causa di errori di sintassi o di direttiva
Docutils/Sphinx può rifiutare o avvisare in caso di sintassi reStructuredText non valida, problemi di rientro o direttive/ruoli non supportati.
- Convalida il documento rispetto alla specifica reStructuredText e risolvi i problemi di rientro/struttura.
- Se stai compilando con Sphinx, conferma che le direttive/ruoli utilizzati sono supportati dalla configurazione e dalle estensioni di Sphinx.
Il testo viene visualizzato con caratteri strani o interruzioni di riga errate
Il file potrebbe utilizzare una codifica o uno stile di fine riga imprevisto.
- Riapri il file e prova una codifica del testo diversa (comunemente UTF-8) nel tuo editor.
- Se necessario, converti i finali di riga (CRLF/LF) utilizzando le impostazioni dell'editor o uno strumento di conversione del testo.
Nota di sicurezza
.rst è testo semplice, ma fai attenzione durante il rendering: reStructuredText supporta le direttive e la creazione con strumenti di documentazione può elaborare riferimenti esterni o includere contenuto a seconda della configurazione dello strumento.