Převod souboru DO do PDF

Skripty Stata .do se běžně ukládají jako PDF pro odevzdání kódu, kontrolu, tisk nebo archivaci, když příjemci nemají příkazy upravovat ani spouštět. PDF zachovává zobrazené rozvržení a otevře se bez Stata.

Přípona .do je nejednoznačná: může se také objevovat v URL adresách obsluhovaných webovými aplikacemi Java. Před převodem zkontrolujte obsah souboru; skript Stata je prostý text a často obsahuje příkazy jako use, regress, generate nebo tabulate.

Co je soubor DO

Do-file Stata je zdrojový soubor v prostém textu obsahující příkazy Stata, komentáře, cesty a kroky analýzy. Obvykle se vytváří v editoru Do-file Editor v Stata, ale může jej otevřít libovolný textový editor.

Soubor .do obsahuje spustitelný kód, nikoli formát rozvržení stránky. Jeho převodem do PDF vznikne vizuální kopie pouze pro čtení; původní soubor si ponechte, protože PDF není vhodné pro úpravy ani opětovné spuštění analýzy.

Pokud soubor pochází z webové adresy končící na .do, může být přípona mapováním servletu, nikoli skutečným typem souboru. Otevřete kopii v textovém editoru: obsah HTML by měl být uložen nebo přejmenován na .html, otevřen v prohlížeči a vytištěn do PDF. Stažení obsahující chybovou stránku, binární data nebo žádný použitelný obsah nelze obecně převést pouze na základě přípony.

Co poskytuje PDF

PDF ukládá reprezentaci s pevnými stránkami, velikostí stránky, rozvržením řádků a volitelně vloženými písmy. Je vhodné pro distribuci kódu jako stabilního záznamu, jeho připojení ke zprávě a tisk bez změn písma nebo zalomení řádků způsobených editorem příjemce.

PDF soubor do-file obsahuje pouze zdrojový kód. Neobsahuje výstup Stata, grafy, tabulky ani data, pokud nejsou tyto položky exportovány samostatně.

Převod do-file Stata do PDF

Tisk ze Stata nebo textového editoru je nejspolehlivější metoda, protože zachovává odsazení kódu a komentáře tak, jak jsou zobrazeny.

1. Otevřete soubor v editoru Do-file Editor v Stata. Pokud Stata není k dispozici, použijte textový editor s podporou tisku, například Notepad++ v systému Windows nebo TextEdit v systému macOS.
2. Vyberte neproporcionální písmo a čitelnou velikost, obvykle 9–11 bodů. Pokud musí každý příkaz zůstat na jednom řádku zdrojového kódu, zakažte zalamování řádků.
3. Použijte File → Print.
4. V systému Windows vyberte Microsoft Print to PDF. V systému macOS vyberte v tiskovém dialogu PDF → Save as PDF. V systému Linux vyberte Print to File a zvolte výstup PDF nebo použijte nainstalovanou PDF tiskárnu.
5. Pokud se dlouhé příkazy zalamují, použijte orientaci na šířku, menší písmo nebo širší formát papíru. Výsledek uložte například jako analysis.pdf.
6. Otevřete PDF a zkontrolujte konce stránek, odsazení, dlouhé řádky a znaky mimo ASCII.

Pro automatizovaný převod v systémech s nainstalovanými GNU Enscript a Ghostscript vytvořte PostScript a převeďte jej do PDF:

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

Tato metoda může u textu v UTF-8 vyžadovat další konfiguraci písem a kódování. Ve výsledném PDF otestujte znaky s diakritikou nebo nelatinské znaky.

Online převod a omezení kompatibility

Online služby pro převod textu do PDF, například CloudConvert, lze použít, když není k dispozici místní tisk. Pokud služba příponu nerozpozná, nahrajte kopii přejmenovanou z analysis.do na analysis.txt, vyberte výstup PDF a ověřte, že výsledek používá neproporcionální písmo a zachovává konce řádků.

Nenahrávejte do převaděče třetí strany skripty obsahující přihlašovací údaje, data účastníků, důvěrné cesty, klíče API nebo nepublikovaný výzkum. Místní tisk do PDF zabrání přenosu zdrojového souboru mimo zařízení.

Při ukládání do-file používejte UTF-8 a pokud je soubor odevzdáván externě, zkontrolujte PDF na jiném zařízení. Chybějící písma nebo kódování tiskárny mohou nahradit znaky, zatímco dlouhé řádky se mohou vizuálně zalamovat, přestože původní skript zůstává beze změny.

Chcete-li zachytit výsledky analýzy, spusťte do-file a exportujte příslušný protokol Stata, grafy nebo tabulky samostatně. Vytištěný do-file nemůže reprodukovat výstup vytvořený během spuštění.