Converti DO in PDF

Gli script Stata .do vengono comunemente salvati come PDF per la consegna, la revisione, la stampa o l'archiviazione del codice, quando i destinatari non devono modificare o eseguire i comandi. Un PDF preserva il layout visualizzato e si apre senza Stata.

L'estensione .do è ambigua: può comparire anche negli URL gestiti da applicazioni web Java. Controllare il contenuto del file prima di convertirlo; uno script Stata è testo normale e spesso contiene comandi come use, regress, generate o tabulate.

Che cos'è un file DO

Un do-file Stata è un file sorgente di testo normale contenente comandi Stata, commenti, percorsi e passaggi di analisi. Normalmente viene creato nell'editor Do-file di Stata, ma può essere aperto con qualsiasi editor di testo.

Un file .do contiene codice eseguibile, non un formato per l'impaginazione. La conversione in PDF crea una copia visiva di sola lettura; conservare il file originale perché il PDF non è adatto a modificare o rieseguire l'analisi.

Se il file proviene da un indirizzo web che termina con .do, l'estensione potrebbe essere una mappatura servlet anziché il tipo effettivo del file. Aprire una copia in un editor di testo: il contenuto HTML deve essere salvato o rinominato come .html, aperto in un browser e stampato in PDF. Un download contenente una pagina di errore, dati binari o nessun contenuto utilizzabile non può essere convertito genericamente in base alla sua estensione.

Che cosa offre il PDF

Il PDF memorizza una rappresentazione a pagine fisse con formato della pagina, disposizione delle righe e, facoltativamente, caratteri incorporati. È adatto per distribuire il codice come documento stabile, allegarlo a un report e stamparlo senza modifiche ai caratteri o all'andata a capo causate dall'editor del destinatario.

Un PDF di un do-file contiene solo il codice sorgente. Non include l'output di Stata, grafici, tabelle o dati, a meno che tali elementi non vengano esportati separatamente.

Convertire un do-file Stata in PDF

La stampa da Stata o da un editor di testo è il metodo più affidabile, perché preserva l'indentazione e i commenti del codice così come vengono visualizzati.

1. Aprire il file nell'editor Do-file di Stata. Se Stata non è disponibile, utilizzare un editor di testo con supporto per la stampa, ad esempio Notepad++ su Windows o TextEdit su macOS.
2. Selezionare un carattere monospaziato e una dimensione leggibile, solitamente 9–11 pt. Disabilitare il ritorno a capo automatico se ogni comando deve rimanere su un'unica riga del sorgente.
3. Utilizzare File → Print.
4. Su Windows, selezionare Microsoft Print to PDF. Su macOS, selezionare PDF → Save as PDF nella finestra di dialogo di stampa. Su Linux, selezionare Print to File e scegliere l'output PDF, oppure utilizzare una stampante PDF installata.
5. Utilizzare l'orientamento orizzontale, un carattere più piccolo o un formato di carta più ampio se i comandi lunghi vanno a capo. Salvare il risultato, ad esempio, come analysis.pdf.
6. Aprire il PDF e controllare interruzioni di pagina, indentazione, righe lunghe e caratteri non ASCII.

Per la conversione automatizzata su sistemi con GNU Enscript e Ghostscript installati, creare un PostScript e convertirlo in PDF:

enscript -f Courier10 -o analysis.ps analysis.do
ps2pdf analysis.ps analysis.pdf

Questo metodo potrebbe richiedere una configurazione aggiuntiva dei caratteri e della codifica per il testo UTF-8. Verificare i caratteri accentati o non latini nel PDF risultante.

Conversione online e limiti di compatibilità

I servizi online di conversione da testo a PDF, come CloudConvert, possono essere utilizzati quando la stampa locale non è disponibile. Caricare una copia rinominata da analysis.do a analysis.txt se il servizio non riconosce l'estensione, selezionare l'output PDF e verificare che il risultato utilizzi un carattere monospaziato e preservi le interruzioni di riga.

Non caricare su un convertitore di terze parti script contenenti credenziali, dati dei partecipanti, percorsi riservati, chiavi API o ricerche non pubblicate. La stampa locale in PDF evita di trasferire il file sorgente al di fuori del dispositivo.

Utilizzare UTF-8 quando si salva il do-file e controllare il PDF su un altro dispositivo se deve essere inviato esternamente. I caratteri mancanti o la codifica della stampante possono sostituire alcuni caratteri, mentre le righe lunghe possono andare visivamente a capo anche se lo script originale rimane invariato.

Per acquisire i risultati dell'analisi, eseguire il do-file ed esportare separatamente il log di Stata, i grafici o le tabelle pertinenti. Un do-file stampato non può riprodurre l'output generato durante l'esecuzione.