Jak zapewne widzieliście z poprzednich artykułów, tutaj w MakeUseOf jesteśmy fanami Markdown. Ucząc się tego prostego i intuicyjnego formatu, możesz łatwo tworzyć ładnie wyglądające wydruki. Od plików PDF po strony internetowe Twój skromny, zwykły plik tekstowy staje się wyrafinowanym dokumentem.

Ale Markdown nie jest jedyną grą w mieście. Istnieje wiele innych tak zwanych lekkich języków znaczników podobnych do Markdown, ale z różnymi zestawami funkcji. Jednym z nich jest Asciidoc. Jeśli lubisz Markdown, ale szukasz trochę więcej pod maską, warto to rozważyć. Oto kilka powodów.

Co to jest “Język znaczników” Tak czy inaczej?

ZA język znaczników to zestaw kodów, które zastosowane do zwykłego tekstu pozwalają na dodanie jednej lub więcej następujących właściwości (między innymi):

• Zdefiniuj tekst
• Struktura tekstu
• Opisz układ tekstu
• Udekoruj tekst

Jednym z języków znaczników, z którym spotykasz się codziennie (chyba że jesteś pustelnikiem), jest Hypertext Markup Language lub HTML. Witryny i aplikacje, które zawierają wiadomości i pokazują wiadomości e-mail, są zbudowane, przynajmniej częściowo, ze znacznikami HTML. Naucz się HTML i CSS za pomocą tych samouczków krok po kroku Naucz się HTML i CSS za pomocą tych samouczków krok po kroku Ciekawy o HTML, CSS i JavaScript? Jeśli uważasz, że masz talent do nauki tworzenia stron internetowych od zera - oto kilka świetnych samouczków, które warto wypróbować. . HTML korzysta z tagi jako mechanizm oznaczania surowej treści tekstowej. Weźmy na przykład następujący fragment kodu HTML:

 
Przedstawiamy HTML
 
Oto akapit w HTML… wiemy, że to ustęp ponieważ otaczające znaczniki \ definiują go jako jeden.
 

Tutaj

tag określa, że ​​cały tekst do śledzenia, aż do jego zamknięcia

Zwróć jednak uwagę na tagi… często służą do definiowania układu strony internetowej, na przykład marginesu z boku ekranu.

I Tagi ozdobią słowo “ustęp” pogrubioną czcionką, podczas gdy

tagi mogą zarówno układać nagłówek (odstępując go od otaczającego tekstu), jak i definiować większą czcionkę.

Problem z niektórymi językami znaczników (w tym HTML) polega na tym, że ręczne wpisywanie tych tagów jest bardzo żmudne. Oraz w innych językach, takich jak XML Co to jest plik XML i jak go otworzyć i używać? Co to jest plik XML i jak go otworzyć i używać? Być może widziałeś termin „XML”. Możliwe, że nawet przypadkowo otworzyłeś plik XML. Co to jest XML i jak go używasz? , tagi i ich atrybuty stanowią większą część ogólnej zawartości niż sam tekst! Spójrz na następujący fragment DocBook, dialekt XML używany do tworzenia wielu publikacji technicznych:

Cały tekst w kolorze fioletowym reprezentuje tagi, które należy wpisać samodzielnie. Pierwszy akapit zaczyna się dopiero na samym dole tego obrazu. A jeśli nie zostanie to zrobione dokładnie zgodnie ze standardem DocBook, nie będzie można przekonwertować go na ładny dokument PDF, który zwykle jest celem końcowym.

Wprowadź lekki język znaczników

Jeśli chcesz skorzystać z języków znaczników, na przykład publikując stronę HTML w Internecie lub konwertując plik DocBook do formatu PDF, aby można go było wydrukować, musisz wykonać jedną z dwóch czynności. Z jednej strony możesz zainwestować czas, ucząc się tych języków od wewnątrz i na zewnątrz, pisząc je ręcznie, a następnie potrójnie sprawdzając swoją pracę. Możesz też zainwestować pieniądze w narzędzie, które zarządza ich złożonością.

Na szczęście niektórzy przedsiębiorczy programiści wymyślili trzecią opcję. Stworzyli nowe języki znaczników, które zawierały wiele (w niektórych przypadkach większość lub wszystkie) cech cięższych odpowiedników, ale znacznie uprościły składnię. Te “lekki” języki obejmują znany 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ś. a także Asciidoc, format Emaca Org-Mode i składnia Mediawiki.

Lekkie języki znaczników mają prostą składnię

Jedną cechą charakterystyczną tych języków jest ich “tagi” (takie jakie są) powinny być intuicyjne. Rzućmy okiem na poprzedni fragment, tym razem napisany w Asciidoc:

Przedstawiamy Asciidoc -------------------- Gdzie są tagi * akapit *? Nie potrzebujemy ich ... Asciidoc jest wystarczająco inteligentny, aby zdać sobie sprawę, że to akapit!

O wiele bardziej czytelny, nie? Zaczynając od góry, możemy zidentyfikować nagłówek, który jest “podkreślone” z myślnikami. Możesz to zrobić, jeśli piszesz ręcznie, po prostu narysuj podkreślenie pod tytułem strony w swoim notatniku. Nie ma też tagów akapitowych - Asciidoc bierze pod uwagę cokolwiek między dwoma pustymi liniami, które nie ma innych znaczników “Równina” tekst akapitu. Wreszcie gwiazdki wokół słowa “ustęp” wskazują pogrubienie. Podnieś rękę, jeśli zrobiłeś to w wiadomości tekstowej, co oznacza dokładnie to samo.

Każdy ma jeden lub więcej odpowiednich procesorów

The “waga ciężka” języki znaczników mają zazwyczaj dedykowaną aplikację do ich interpretacji. W Internecie to Twoja przeglądarka, a także serwer WWW zamieniają kod w krzykliwe strony internetowe Wszystko, co musisz wiedzieć o systemach zarządzania treścią Wszystko, co musisz wiedzieć o systemach zarządzania treścią Dla przeciętnego internauty, przeglądanie treści jest proste. Po otwarciu linku pojawi się strona. Ale co dzieje się za kulisami? Oto jak Twoje ulubione CMS dbają o biznes. . W przypadku dokumentów w formacie XML może to być coś w rodzaju Microsoft Word, który odczytuje i zapisuje w formacie DOCX Jak otwierać pliki DOCX programu Microsoft Word 2007 Jak otwierać pliki DOCX programu Microsoft Word 2007 Czy kiedykolwiek otrzymałeś jeden z tych plików z rozszerzeniem .docx i zastanawiałeś się, co z tym zrobić? Nie można go wyświetlić w starszych wersjach programu Word, więc jak otworzyć plik .docx… (który jest innym dialektem XML). Dzięki temu nigdy nie musisz bezpośrednio wchodzić w interakcję ze źródłem tych dokumentów, tylko ładne fasady, które pokazują twoje aplikacje.

Tymczasem dokumenty napisane w lekkich językach są czytelne dla człowieka w formie źródłowej (inny najemca), ale tylko prawdziwi kujony mogą myśleć, że są piękne. Aby uzyskać ładny wynik, musisz użyć edytor. Są to aplikacje, które będą przebiegać przez linię znaczników po linii i przekształcać ją w coś, co wygląda dobrze. Te same projekty, które opracowują sam język, zazwyczaj tworzą narzędzie do jego obsługi. Projekt Markdown oferuje skrypt Perla o tej samej nazwie, a program towarzyszący Asciidoc jest napisany w Pythonie. Ponadto inne narzędzia do konwersji będą obsługiwać niektóre z tych języków. Jednym z takich jest doskonały Pandoc Jak łatwo konwertować formaty dokumentów w systemie Linux Jak łatwo konwertować formaty dokumentów w systemie Linux Przejście na system Linux może powodować problemy ze zgodnością plików. Na przykład dokumenty nie wyglądają tak samo w LibreOffice, jak w programie Word. To tylko jeden powód, dla którego potrzebujesz pandoc. , który weźmie Markdown, a także lekkie znaczniki reStructured Text, Mediawiki i Org-Mode i skonwertuje je do formatu PDF, DOCX, ODT i innych.

W rezultacie lekkie języki znaczników pozwalają na pracę w formacie zwykłego tekstu, najbardziej przenośnego formatu danych na świecie, a mimo to generują ładnie wyglądające wyniki. Teraz, gdy jesteś przekonany o jego zaletach, jaki język wybrać? Markdown jest bez wątpienia najpopularniejszym i ma swoje zalety (więcej na ten temat później). Ale w szczególności Asciidoc jest godną alternatywą. W następnej sekcji wyjaśnimy kilka powodów.

Porównywanie Markdown i Asciidoc

Format Asciidoc został stworzony w celu zapewnienia lekkości i prostoty DocBook, jednego z bardziej popularnych formatów pisania długiego (szczególnie technicznego). Jednym z twierdzeń o sławie jest to, że jest to tłumaczenie jeden na jeden, co oznacza, że ​​dla każdego elementu w DocBook istnieje odpowiednia reprezentacja w Asciidoc. Poniżej przyjrzymy się zaletom i wadom Asciidoc w porównaniu do Markdown.

Asciidoc obejmuje zestaw elementów pisarskich

Celem Markdown od samego początku był prosty format dla pisarzy internetowych. Jako takie, obsługiwane przez niego elementy do pisania (przynajmniej oryginalna implementacja, patrz poniżej) skupiają się na automatyzacji bardziej czasochłonnych aspektów pisania HTML (na przykład listy, które wymagają

lub
tagi oprócz
• tagi dla każdego elementu).

  

  Asciidoc również je zawiera, ale oferuje również bardziej zaawansowane elementy DocBook, takie jak napomnienia (np. “Uwaga:” lub “Informacje:” bloki objaśnień) i złożone układy tabel. To nie znaczy, że ty potrzeba korzystać z nich przez cały czas, ale będą one dostępne i dostępne, jeśli będziesz ich potrzebować.

  Asciidoc to ujednolicony format

  Kiedy popularność Markdown zaczęła się rozrastać, niektórzy z jego użytkowników zaczęli napotykać niektóre z omawianych wyżej niedociągnięć. Użytkownicy ci zaczęli opracowywać własne rozszerzenia, aby rozwiązać te problemy, takie jak możliwość dodawania tabel lub przypisów / przypisów końcowych. Wkrótce było ich wielu “smaki” Markdown, w tym (między innymi):

  • Smak używany przez Github do “Readme” pliki projektów, które były hostowane.
  • Na “rozszerzony” smak zrodzony z portu PHP oryginalnego Markdown z dodatkowymi funkcjami związanymi z HTML.
  • Smak o nazwie “MultiMarkdown” który zaimplementował wiele funkcji pisania w dłuższej formie, w tym cytaty, definicje i odsyłacze.

  W rezultacie dokument może wymagać elementów, które nie są objęte jednym smakiem. W przeciwieństwie do tego, Asciidoc nie cierpi z powodu tej samej fragmentacji, co obecnie Markdown.

  Asciidoc jest ukierunkowany na różne style publikowania

  Markdown jest świetny do szybkiego usuwania postów z bloga z głowy i na stronę. Ale po wyjęciu z pudełka nie jest przeznaczony do tworzenia dłuższych prac, jak książka. Asciidoc jest do tego przeznaczony, a jednym z przykładów jest “zawierać” Funkcje. Te instrukcje pozwalają na zawarcie całej zawartości jednego pliku w innym:

  include :: somefile.adoc

  Nie różni się to od działania Dokumentów głównych w edytorach tekstu. Umożliwia to na przykład naszkicowanie każdego rozdziału jako osobnego pliku “zawierać” wszystkie w jednym pliku reprezentującym książkę. Kiedy to przetworzysz “plik książki,” wynik będzie wyglądał tak, jakby wszystkie rozdziały zostały zapisane bezpośrednio w tym dokumencie.

  Przecena jest wystarczająca dla większości użytkowników

  Markdown obejmuje wszystkie bazy dla większej części użytkowników. Dla tych, którzy chcą po prostu pisać na blogu lub pisać notatki w formacie zwykłego tekstu, Markdown obsługuje wszystkie potrzebne elementy. Odsyłacze niewiele znaczą dla użytkownika, który chce po prostu utworzyć prostą notatkę lub stronę internetową. Możesz nawet użyć Markdown do dłuższych prac z prostymi układami, na przykład powieści Who Needs Scrivener? 5 nowatorskich aplikacji do pisania dla systemu Linux Kto potrzebuje Scrivenera? 5 Nowe aplikacje do pisania dla systemu Linux Scrivener nie jest dostępny dla systemu Linux - więc jak będziesz śledzić, dokąd idą te postacie, co zrobili i jak ukończą swoją podróż? Cóż, jedno z tych narzędzi powinno pomóc. i połącz je sam na końcu.

  Markdown jest lepiej obsługiwany

  Ponieważ Markdown spełnia potrzeby większego segmentu użytkowników, ostatecznie jest lepiej obsługiwany pod względem:

  • Redaktorzy WYSIWYG (zdefiniowani przez tych, którzy przynajmniej zapewniają podgląd na żywo) są znacznie bardziej skłonni do wspierania Markdown.
  • Usługi online, takie jak wyżej wspomniany Github, częściej przyjmują Markdown bezpośrednio lub za pomocą dodatków. 6 edytorów Markdown, które grają w przyjemny z Dyskiem Google 6 edytorów Markdown, które grają w przyjemny z Google Drive Markdown to format edycji tekstu przyszłości. Jest prostszy, bardziej elegancki i łatwiejszy w użyciu niż HTML bez poświęcania dużej mocy lub elastyczności. .
  • Chociaż systemy publikowania, takie jak statyczne generatory witryn 7 powodów, by porzucić CMS i rozważyć statyczny generator witryn 7 powodów, by porzucić swój CMS i rozważyć statyczny generator witryn Przez wiele lat opublikowanie strony internetowej było trudne dla wielu użytkowników. CMS takie jak WordPress to zmieniły, ale wciąż mogą być mylące. Inną alternatywą jest statyczny generator stron. często wspierają Asciidoc za pomocą wtyczek, że wsparcie Markdown po wyjęciu z pudełka jest prawie pewne.

  Czy chcesz wypróbować Asciidoc??

  Podczas gdy Markdown jest de facto wyborem spośród lekkich języków znaczników, Asciidoc zawiera wszystkie te same elementy, a następnie niektóre. Dodatki do Asciidoc wymagają trochę czasu na naukę, ponieważ mogą lepiej przygotować cię do większych i bardziej złożonych projektów pisania.

  Co myślisz? Czy jesteś zadowolony z prostoty Markdown? A może tworzysz własny wielokanałowy obieg publikacji z kuszącym Asciidoc? Być może nienawidzisz zwykłego tekstu, a to Word jest dla ciebie od zawsze? Daj nam znać w komentarzach poniżej!