Come aprire file .RST su Linux
Per aprire file .RST su Linux, apri il primo file in qualsiasi editor di testo per visualizzare o modificare il markup.
Istruzioni passo passo
- Apri il primo file in qualsiasi editor di testo per visualizzare o modificare il markup.
- Per vedere l'output formattato, renderizzalo con Docutils o crea documentazione con Sphinx.
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.