Konwertuj DO na PDF

Skrypty Stata .do są często zapisywane jako PDF na potrzeby przesyłania kodu, przeglądu, drukowania lub archiwizacji, gdy odbiorcy nie powinni edytować ani uruchamiać poleceń. PDF zachowuje wyświetlany układ i otwiera się bez programu Stata.

Rozszerzenie .do jest niejednoznaczne: może również występować w adresach URL obsługiwanych przez aplikacje internetowe Java. Przed konwersją sprawdź zawartość pliku; skrypt Stata jest zwykłym tekstem i często zawiera polecenia takie jak use, regress, generate lub tabulate.

Czym jest plik DO

Plik do Stata jest plikiem źródłowym w formacie zwykłego tekstu, zawierającym polecenia Stata, komentarze, ścieżki i etapy analizy. Zwykle jest tworzony w edytorze Do-file programu Stata, ale może go otworzyć dowolny edytor tekstu.

Plik .do zawiera kod wykonywalny, a nie format układu strony. Konwersja do PDF tworzy wizualną kopię tylko do odczytu; zachowaj oryginalny plik, ponieważ PDF nie nadaje się do edytowania ani ponownego uruchamiania analizy.

Jeśli plik pochodził z adresu internetowego kończącego się na .do, rozszerzenie może oznaczać mapowanie serwletu, a nie rzeczywisty typ pliku. Otwórz kopię w edytorze tekstu: zawartość HTML należy zapisać lub zmienić jej nazwę na .html, otworzyć w przeglądarce i wydrukować do PDF. Pobranego pliku zawierającego stronę błędu, dane binarne lub brak użytecznej zawartości nie można ogólnie przekonwertować na podstawie samego rozszerzenia.

Co zapewnia PDF

PDF przechowuje reprezentację o stałym układzie stron, z rozmiarem strony, układem wierszy i opcjonalnie osadzonymi czcionkami. Nadaje się do rozpowszechniania kodu jako stabilnego zapisu, dołączania go do raportu i drukowania bez zmian czcionek lub zawijania wierszy powodowanych przez edytor odbiorcy.

PDF pliku do zawiera wyłącznie kod źródłowy. Nie zawiera wyników Stata, wykresów, tabel ani danych, chyba że te elementy zostaną wyeksportowane osobno.

Konwersja pliku do Stata do PDF

Drukowanie z programu Stata lub edytora tekstu jest najbardziej niezawodną metodą, ponieważ zachowuje wyświetlane wcięcia kodu i komentarze.

1. Otwórz plik w edytorze Do-file programu Stata. Jeśli Stata jest niedostępna, użyj edytora tekstu obsługującego drukowanie, takiego jak Notepad++ w systemie Windows lub TextEdit w systemie macOS.
2. Wybierz czcionkę o stałej szerokości i czytelny rozmiar, zwykle 9–11 pkt. Wyłącz zawijanie wierszy, jeśli każde polecenie musi pozostać w jednym wierszu źródłowym.
3. Użyj polecenia File → Print.
4. W systemie Windows wybierz Microsoft Print to PDF. W systemie macOS wybierz PDF → Save as PDF w oknie dialogowym drukowania. W systemie Linux wybierz Print to File i ustaw wyjście PDF albo użyj zainstalowanej drukarki PDF.
5. Jeśli długie polecenia są zawijane, użyj orientacji poziomej, mniejszej czcionki lub szerszego rozmiaru papieru. Zapisz wynik na przykład jako analysis.pdf.
6. Otwórz PDF i sprawdź podziały stron, wcięcia, długie wiersze oraz znaki inne niż ASCII.

W celu automatycznej konwersji w systemach z zainstalowanymi programami GNU Enscript i Ghostscript utwórz PostScript, a następnie przekonwertuj go do PDF:

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

Ta metoda może wymagać dodatkowej konfiguracji czcionek i kodowania dla tekstu UTF-8. Sprawdź znaki diakrytyczne lub znaki alfabetów innych niż łaciński w wynikowym pliku PDF.

Konwersja online i ograniczenia zgodności

Internetowe usługi konwersji tekstu do PDF, takie jak CloudConvert, mogą być używane, gdy drukowanie lokalne jest niedostępne. Prześlij kopię o zmienionej nazwie z analysis.do na analysis.txt, jeśli usługa nie rozpoznaje rozszerzenia, wybierz wyjście PDF i sprawdź, czy wynik używa czcionki o stałej szerokości oraz zachowuje podziały wierszy.

Nie przesyłaj do konwertera zewnętrznego skryptów zawierających dane uwierzytelniające, dane uczestników, poufne ścieżki, klucze API ani nieopublikowane badania. Lokalne drukowanie do PDF pozwala uniknąć przesyłania pliku źródłowego poza urządzenie.

Podczas zapisywania pliku do używaj UTF-8 i sprawdź PDF na innym urządzeniu, jeśli ma być przesłany na zewnątrz. Brakujące czcionki lub kodowanie drukarki mogą zastępować znaki, a długie wiersze mogą być wizualnie zawijane, mimo że oryginalny skrypt pozostaje niezmieniony.

Aby uwzględnić wyniki analizy, uruchom plik do i wyeksportuj odpowiedni log Stata, wykresy lub tabele osobno. Wydrukowany plik do nie może odtworzyć wyników wygenerowanych podczas wykonywania.