Jak otwierać i konwertować POD na PDF, aby czytać dokumentację Perla

  • Michael Cain
  • 0
  • 1073
  • 99
Reklama

Chociaż niegdyś był to integralny język programowania WWW Który język programowania się uczyć - Programowanie sieciowe Który język programowania się uczyć - Programowanie internetowe Dzisiaj przyjrzymy się różnym językom programowania internetowego, które napędzają Internet. To czwarta część serii programowania dla początkujących. W części 1 nauczyliśmy się podstaw… Perl odszedł na bok na korzyść bardziej nowoczesnych języków, takich jak Python, Ruby i JavaScript. Bardzo niewiele osób uważa, że ​​warto dziś nauczyć się Perla.

Ale to nie znaczy, że język jest bezużyteczny lub przestarzały. W rzeczywistości wiele nowoczesnych stron internetowych i narzędzi internetowych wciąż polega na Perlu w codziennych operacjach - w tym Craigslist, IMDb i DuckDuckGo - więc jeśli chcesz się tego nauczyć, nie pozwól nikomu cię powstrzymać ani odwieść 7 Przydatnych sztuczek do opanowania nowego języka programowania 7 Przydatnych sztuczek do opanowania nowego języka programowania Możesz być przytłoczony, kiedy uczysz się kodować. Prawdopodobnie zapomnisz o rzeczach tak szybko, jak się ich nauczysz. Te wskazówki pomogą ci lepiej zachować wszystkie nowe informacje. .

Jeśli masz zamiar nauczyć się Perla, musisz także zapoznać się z POD. Oto, co to jest, dlaczego jest to ważne i co zrobić, gdy napotkasz takie pliki.

Co to są pliki POD?

POD oznacza Plain Old Documentation, który jest podstawowym językiem znaczników używanym do formatowania tekstu bez większego wysiłku. Jest podobny do języka znaczników Markdown Czym jest Markdown? 4 powody, dla których powinieneś się tego teraz nauczyć Czym jest Markdown? 4 powody, dla których powinieneś się tego nauczyć Masz już dość edytorów HTML i WYSIWYG? Zatem Markdown jest dla ciebie odpowiedzią bez względu na to, kim jesteś. , ale specjalnie zaprojektowany do dokumentowania kodu źródłowego i modułów Perla.

POD można używać na dwa sposoby: może istnieć bezpośrednio w kodzie źródłowym pliku Perl LUB może istnieć jako osobny plik POD. Jeśli istnieje w kodzie, możesz myśleć o nim jak o komentarzach w dowolnym innym języku programowania, z wyjątkiem bardziej wyszukanych i bardziej elastycznych.

#! / usr / bin / perl

stosować ścisłe;

używać ostrzeżeń;

= strąk

= nagłówek Przykład nagłówka 1

Ten skrypt robi fajne rzeczy, takie jak to i tamto. Aby działał poprawnie, muszą istnieć następujące parametry. Nie próbuj tego robić na komputerze z problemami.

= cięcie

wydrukować “Wykonywany jest tylko ten kod. \ n”;

Dokumentacja osadzona działa dobrze w przypadku samodzielnych skryptów lub gdy chcesz się upewnić, że każdy, kto natknie się na plik, ma również zagwarantowany dostęp do dokumentacji, ale może być kłopotliwy, gdy chcesz udokumentować całą bazę kodu na wyższym poziomie.

Na szczęście POD można także wykorzystać do tworzenia stron o typie ręcznym, które lepiej nadają się do dokumentów zorientowanych na użytkownika (ponieważ użytkownicy mogą nie chcieć zagłębiać się w kod źródłowy samego skryptu). Wtedy przydają się pliki POD.

Jak czytać pliki POD

Dla jasności, osadzona dokumentacja POD znajduje się w rzeczywistych plikach skryptów Perla pomiędzy wierszami kodu, a te pliki skryptów mają jeden z dwóch formatów rozszerzeń: .PL lub .PM. Gdy zobaczysz rozszerzenie .POD, oznacza to, że plik jest czystą dokumentacją i nie zawiera kodu źródłowego.

Chociaż można otwierać pliki POD w dowolnym edytorze tekstu, w tym w Notatniku, prawdopodobnie chcesz to zrobić tylko wtedy, gdy edytujesz samą surową dokumentację. Pomyśl o tym jak o otwarciu pliku HTML w edytorze: przy wszystkich znacznikach trudno jest odczytać rzeczywistą treść tekstu.

Zamiast tego powinieneś użyć jakiegoś narzędzia czytającego, które pobiera surową dokumentację POD i przedstawia ją w sposób łatwy do odczytania.

Najprostszym sposobem jest użycie perldoc narzędzie wiersza poleceń, które jest automatycznie dołączane, gdy Perl jest zainstalowany w twoim systemie. Większość systemów OS X i Linux jest już z zainstalowanym Perlem, ale użytkownicy Windows będą musieli go zainstalować ręcznie. (Na szczęście nie jest to trudniejsze niż uruchomienie pliku instalatora.)

Teraz uruchom wiersz poleceń, przejdź do lokalizacji pliku POD i wpisz perldoc [plik .POD] aby wyświetlić go jako poprawnie sformatowanego. Na przykład, jeśli plik został nazwany biblioteka.pod wtedy napiszesz perldoc library.pod i to wszystko.

Jak przekonwertować POD na inne formaty

Nawet jeśli perldoc narzędzie nie jest zbyt trudne w użyciu, nie jest zbyt wygodne, gdy chcesz udostępnić dokumentację innym osobom lub chcesz odczytać ją poza komputerem. Wtedy możesz rozważyć konwersję na inny format.

Konwersja do HTML: Zainstaluj i użyj narzędzia pod2html, które zapewnia łatwy sposób na przetłumaczenie dowolnego pliku POD na czytelny plik HTML. Niestety może wykonać tylko konwersję jeden do jednego (więc nie można łączyć wielu plików POD w jeden plik HTML).

Konwersja do formatu PDF: Zainstaluj i użyj narzędzia pod2pdf, które jest podobne i równie łatwe w użyciu, jak powyższe narzędzie pod2html, z tym że konwertuje ono na format PDF, a nie HTML.

Inną opcją byłoby przekonwertowanie POD na HTML przy użyciu metody pokazanej powyżej, otwarcie pliku HTML w przeglądarce takiej jak Chrome lub Firefox, a następnie wydrukowanie strony jako PDF.

Konwersja na obniżkę: Zainstaluj i użyj narzędzia pod2markdown, aby tłumaczyć między POD i Markdown. Markdown to język znaczników ogólnego przeznaczenia, co oznacza, że ​​użytkownicy chętniej go znają, a dostępnych jest więcej narzędzi, które mogą akceptować i wyświetlać Markdown.

Konwersja do LaTeX: Zainstaluj i użyj narzędzia pod2latex. LaTeX to kolejny język znaczników, który jest mniej powszechny niż Markdown, ale wciąż bardziej popularny niż POD. LaTeX jest używany głównie w dokumentach naukowych i naukowych, ale w razie potrzeby ten konwerter istnieje.

Konwertowanie na zwykły tekst: Zainstaluj i użyj narzędzia pod2text, które tworzy plik tekstowy z formatowaniem opartym na ASCII. Prawdopodobnie nie będziesz musiał tego używać, ale na wszelki wypadek wiedz, że istnieje taka opcja.

Czy ten post był pomocny??

Po zrozumieniu, pliki POD są niezwykle proste i wygodne w użyciu. Jest trochę krzywej uczenia się, ale jest bardzo niewielka - szczególnie jeśli wcześniej używałeś języka znaczników. Mam nadzieję, że teraz czujesz się swobodnie w pracy z plikami POD.

Jeśli czujesz się przytłoczony, zadaj sobie te ważne pytania dla początkujących programistów. 4 pytania, które musisz sobie zadać, zanim nauczysz się kodować. 4 pytania, które zadaj sobie, zanim nauczysz się, jak kodować. Nauka języka programowania jest popularna. Ale czy to dla wszystkich? Zanim się do tego zobowiązasz, zadaj sobie następujące pytania i bądź szczery. . Trudności niekoniecznie oznaczają, że nie jesteś programistą. 6 znaków, że nie jesteś programistą. 6 znaków, że nie jesteś programistą. Nie wszyscy są programistami. Jeśli nie masz całkowitej pewności, że chcesz zostać programistą, oto kilka znaków, które mogą skierować Cię w dobrym kierunku. , ale ważne jest, aby być uczciwym wobec siebie i zarządzać swoimi oczekiwaniami.

Biorąc to pod uwagę, zapoznaj się z tymi wskazówkami, aby nauczyć się kodować bez stresu Jak nauczyć się programować bez stresu Jak nauczyć się programować bez stresu Być może zdecydowałeś się kontynuować programowanie, czy to dla kariery, czy dla hobby. Świetny! Ale może zaczynasz czuć się przytłoczony. Nie za dobrze. Oto pomoc w ułatwieniu podróży. i wiedząc, jak odróżnić dobre samouczki programowania od złego Co sprawia, że ​​dobry samouczek programowania? Co stanowi dobry poradnik programowania? Nie wszystkie samouczki dotyczące programowania są sobie równe. Niektóre przynoszą korzyści Tobie, a inne marnują Twój czas. Oto, czego szukać w samouczku programowania jakości. .

Do czego używasz Perla? Masz jeszcze jakieś wskazówki lub pytania? Daj nam znać w komentarzach poniżej!




Jeszcze bez komentarzy

O nowoczesnej technologii, prostej i niedrogiej.
Twój przewodnik w świecie nowoczesnych technologii. Dowiedz się, jak korzystać z technologii i gadżetów, które nas otaczają każdego dnia i dowiedz się, jak odkrywać ciekawe rzeczy w Internecie.