Lightweight Markup Languages ​​Aus diesem Grund sollten Sie AsciiDoc gegenüber dem regulären Markdown verwenden

Lightweight Markup Languages ​​Aus diesem Grund sollten Sie AsciiDoc gegenüber dem regulären Markdown verwenden / Technologie erklärt

Wie Sie wahrscheinlich in den letzten Artikeln gesehen haben, sind wir hier bei MakeUseOf Fans von Markdown. Durch das Erlernen dieses einfachen und intuitiven Formats können Sie leicht schön aussehende Ausgaben erstellen. Von PDFs bis zu Webseiten wird Ihre einfache Textdatei zu einem hoch entwickelten Dokument.

Aber Markdown ist nicht das einzige Spiel in der Stadt. Es gibt eine Reihe von anderen so genannten Lightweight-Auszeichnungssprachen, die ähnlich wie Markdown sind, aber unterschiedliche Funktionssätze aufweisen. Eines davon ist Asciidoc. Wenn Sie Markdown mögen, aber etwas mehr unter der Haube suchen, ist es eine Überlegung wert. Hier sind einige Gründe warum.

Was ist ein “Auszeichnungssprache” Sowieso?

EIN Auszeichnungssprache ist eine Reihe von Codes, die es Ihnen ermöglichen, eine oder mehrere der folgenden Eigenschaften (unter anderem) hinzuzufügen:

  • Definieren Sie den Text
  • Strukturieren Sie den Text
  • Beschreiben Sie das Layout des Textes
  • Verzieren Sie den Text

Eine Markup-Sprache, der Sie täglich begegnen (es sei denn, Sie sind ein Einsiedler), ist Hypertext Markup Language oder HTML. Die Websites und Anwendungen, die Sie mit Neuigkeiten versorgen und Ihnen Ihre E-Mail zeigen, sind zumindest teilweise mit HTML-Markup erstellt. Lernen Sie HTML und CSS mit diesen Step-by-Step-Tutorials. Lernen Sie HTML und CSS mit diesen Step-by-Step-Tutorials und JavaScript? Wenn Sie der Meinung sind, wie Sie eine Website von Grund auf neu erstellen können, dann haben Sie hier einige großartige Schritt-für-Schritt-Anleitungen, die einen Versuch wert sind. Weiterlesen . HTML macht Gebrauch von Stichworte als Mechanismus zum Markieren des Rohtextinhalts. Betrachten Sie beispielsweise das folgende HTML-Snippet:

 

HTML einführen

Hier ist ein Absatz in HTML… wir wissen, dass es ein ist Absatz weil die umgebung \ Tags definieren es als eins.

Hier die

tag gibt an, dass der gesamte Text bis zu seinem Abschluss folgt

tag ist ein Absatz. In diesem Sinne ist es so definiert der Text als Absatz.

Beachten Sie aber auch die Tags… diese dienen häufig dazu, das Layout einer Webseite zu definieren, z. B. wie viel Rand seitlich des Bildschirms vorhanden ist.

Und das Tags werden das Wort schmücken “Absatz” in einer fetten Schrift, während die

Tags können sowohl die Überschrift (Abstand zum umgebenden Text) als auch eine größere Schrift definieren.

Bei einigen Auszeichnungssprachen (darunter auch HTML) besteht das Problem, dass das manuelle Tippen dieser Tags eine sehr langwierige Angelegenheit ist. Und mit anderen Sprachen wie XML Was ist eine XML-Datei und was verwendet sie? [Falls Sie sich gefragt haben] Was ist eine XML-Datei und wozu werden sie verwendet? [Falls Sie sich wunderten] Lesen Sie mehr, die Tags und ihre Attribute machen einen größeren Teil des Gesamtinhalts aus als der Text selbst! Schauen Sie sich das folgende DocBook-Snippet an, einen XML-Dialekt, mit dem viele technische Publikationen erstellt werden:

Der gesamte violette Text stellt Tags dar, die Sie selbst eingeben müssen. Der erste Absatz beginnt erst ganz unten im Bild. Und wenn es gemäß dem DocBook-Standard nicht genau richtig ist, können Sie es nicht in ein hübsches PDF-Dokument konvertieren, das normalerweise das Endziel ist.

Geben Sie die Lightweight-Auszeichnungssprache ein

Wenn Sie Markup-Sprachen nutzen möchten, z. B. eine HTML-Seite im Web veröffentlichen oder eine DocBook-Datei in PDF konvertieren möchten, damit sie gedruckt werden kann, müssen Sie zwei verschiedene Schritte ausführen. Einerseits könnten Sie Zeit investieren, indem Sie diese Sprachen von innen und außen lernen, von Hand schreiben und dann Ihre Arbeit dreifach überprüfen. Oder Sie investieren Geld in ein Tool, das die Komplexität für Sie verwaltet.

Zum Glück hatten einige Entwickler eine dritte Option. Sie erstellten neue Auszeichnungssprachen, die viele (in manchen Fällen die meisten oder alle) der Funktionen der schwereren Gegenstücke enthielten, die Syntax jedoch stark vereinfachten. Diese “Leicht” Sprachen enthalten das bekannte Markdown Was ist Markdown? 4 Gründe, warum Sie es jetzt lernen sollten Was ist Markdown? 4 Gründe, warum Sie es jetzt lernen sollten Ermüdet von HTML- und WYSIWYG-Editoren? Dann ist Markdown die Antwort für Sie, egal wer Sie sind. Lesen Sie mehr sowie Asciidoc, das Org-Mode-Format von Emac und die Mediawiki-Syntax.

Lightweight Markup Languages ​​haben einfache Syntax

Ein Markenzeichen dieser Sprachen ist ihre “Stichworte” (wie sie sind) sollte intuitiv sein. Schauen wir uns den vorherigen Ausschnitt an, diesmal in Asciidoc:

Einführung in Asciidoc -------------------- Wo sind die * Absatz * -Tags? Wir brauchen sie nicht ... Asciidoc ist klug genug, um zu erkennen, dass dies ein Absatz ist!

Viel lesbarer, nein? Wenn wir oben beginnen, können wir die Überschrift als solche identifizieren “unterstrichen” mit Bindestrichen. Sie könnten dies auch tun, wenn Sie handschriftlich sind. Zeichnen Sie einfach eine Unterstreichung unter dem Titel der Seite in Ihrem Notizbuch. Es gibt auch keine Absatz-Tags - Asciidoc betrachtet alles zwischen zwei leeren Zeilen, das keine anderen Markierungen enthält “einfach” Absatztext. Zum Schluss noch die Sternchen um das Wort “Absatz” Fettdruck anzeigen. Erheben Sie Ihre Hand, wenn Sie dies in einer SMS getan haben, um genau dasselbe zu bedeuten.

Jeder hat einen oder mehrere korrespondierende Prozessoren

Das “Schwergewicht” Markup-Sprachen haben normalerweise eine spezielle Anwendung, um sie für Sie zu interpretieren. Im Internet ist es Ihr Browser und möglicherweise auch der Webserver, der den Code in auffällige Webseiten umwandelt. Alles, was Sie über Content-Management-Systeme wissen müssen. Alles, was Sie über Content-Management-Systeme wissen müssen. Für durchschnittliche Internet-Surfer: Anzeigen von Inhalten ist einfach. Sie öffnen einen Link und die Seite wird angezeigt. Aber was findet hinter den Kulissen statt? So erledigen Ihre Lieblings-CMSs Ihre Geschäfte. Weiterlesen . Bei XML-Dokumenten handelt es sich möglicherweise um Microsoft Word, das das DOCX-Format liest und schreibt. So öffnen Sie Microsoft Word 2007-DOCX-Dateien So öffnen Sie Microsoft Word 2007-DOCX-Dateien Haben Sie jemals eine dieser Dateien mit der Erweiterung .docx und erhalten fragte mich, was ich damit anfangen sollte? Es kann nicht in älteren Word-Versionen angezeigt werden. Wie kann man also eine .docx-Datei öffnen? Lesen Sie mehr (was ein anderer XML-Dialekt ist). So müssen Sie nie direkt mit der Quelle dieser Dokumente interagieren, nur die hübschen Fassaden, die Ihre Apps Ihnen zeigen.

Dokumente, die in einfachen Sprachen verfasst sind, sind in Quellform (einem anderen Mieter) lesbar, aber nur echte Nerds mögen denken, dass sie schön sind. Um eine gute Ausgabe zu erhalten, müssen Sie eine Prozessor. Dies sind Anwendungen, die Ihre Markierungen Zeile für Zeile durchlaufen und in etwas anderes konvertieren, das gut aussieht. Die gleichen Projekte, die die Sprache selbst entwickeln, werden in der Regel ein entsprechendes Hilfsprogramm erzeugen. Das Markdown-Projekt bietet ein gleichnamiges Perl-Skript, und Asciidocs Begleitprogramm ist in Python geschrieben. Außerdem werden andere Konvertierungsprogramme einige dieser Sprachen unterstützen. Eine davon ist der exzellente Pandoc. So konvertieren Sie problemlos zwischen Dokumentformaten in Linux. So konvertieren Sie problemlos zwischen Dokumentformaten in Linux. Der Wechsel zu Linux kann zu Problemen mit der Dateikompatibilität führen. Beispielsweise sehen Dokumente in LibreOffice nicht gleich aus wie in Word. Dies ist nur ein Grund, warum Sie Pandoc brauchen. Read More, das Markdown sowie leichtgewichtige Markups, reStructured Text, Mediawiki und Org-Mode in PDF, DOCX, ODT und mehr konvertiert.

Das Ergebnis ist, dass mit einfachen Markup-Sprachen Sie in Klartext arbeiten können, dem tragbarsten Datenformat der Welt, und dennoch eine schön aussehende Ausgabe erzeugen. Nun, da Sie von den Vorteilen überzeugt sind, welche Sprache sollten Sie wählen? Markdown ist zweifellos der populärste und hat seine Vorteile (mehr dazu später). Aber gerade Asciidoc ist eine gute Alternative. Im nächsten Abschnitt werden wir einige Gründe dafür untersuchen.

Vergleich von Markdown und Asciidoc

Das Asciidoc-Format wurde geschaffen, um DocBook, einem der am weitesten verbreiteten Formate im Langformschreiben (vor allem im technischen Bereich), auf einfache Weise zu vereinfachen. Es ist bekannt, dass es sich um eine Eins-zu-Eins-Übersetzung handelt, dh für jedes Element in DocBook gibt es eine entsprechende Darstellung in Asciidoc. Nachfolgend betrachten wir einige Vor- und Nachteile von Asciidoc im Vergleich zu Markdown.

Asciidoc umfasst eine Obermenge von Schreibelementen

Markdowns Ziel war von Anfang an, ein einfaches Format für Web-Autoren zu sein. Daher konzentrieren sich die von ihm unterstützten Schreibelemente (zumindest die Originalimplementierung, siehe unten) auf die Automatisierung der zeitintensiveren Aspekte des Schreibens von HTML (z. B. Listen, für die der Text benötigt wird)

    oder
      Tags zusätzlich zu
    • Tags für jeden Artikel).

      Asciidoc enthält diese ebenfalls, bietet jedoch auch fortschrittlichere DocBook-Elemente wie etwa Ermahnungen (z. “Hinweis:” oder “Info:” Callout-Blöcke) und komplexe Tabellenlayouts. Es bedeutet nicht dich brauchen um sie die ganze Zeit zu nutzen, aber sie werden zur Verfügung stehen, wenn Sie sie jemals brauchen.

      Asciidoc ist ein einheitliches Format

      Als die Popularität von Markdown begann, begannen einige Benutzer, einige der oben diskutierten Mängel zu bemerken. Daher begannen diese Benutzer, eigene Erweiterungen zu entwickeln, um diese Probleme zu lösen, beispielsweise die Möglichkeit, Tabellen oder Fuß- / Endnoten hinzuzufügen. Bald gab es viele “Aromen” von Markdown, einschließlich (unter anderem):

      • Der Geschmack, den Github für den “Readme” Dateien der von ihr gehosteten Projekte.
      • Ein “verlängert” Geschmack, der aus einem PHP-Port des ursprünglichen Markdowns mit zusätzlichen HTML-Funktionen entsteht.
      • Eine Flavour genannt “MultiMarkdown” Dies implementierte viele Funktionen des Langformschreibens, einschließlich Zitate, Definitionen und Querverweise.

      Das Ergebnis ist, dass für Ihr Dokument möglicherweise Elemente erforderlich sind, die nicht alle von einer einzigen Variante erfasst werden. Im Gegensatz dazu leidet Asciidoc nicht an der gleichen Fragmentierung, die Markdown derzeit macht.

      Asciidoc zielt auf eine Vielzahl von Veröffentlichungsstilen ab

      Markdown eignet sich hervorragend, um einen Blog-Post schnell aus dem Kopf und auf die Seite zu bekommen. Es ist jedoch nicht für die Strukturierung längerer Werke wie ein Buch gedacht. Asciidoc ist dafür konzipiert und ein Beispiel ist sein “umfassen” Funktionen. Mit diesen Anweisungen können Sie den gesamten Inhalt einer Datei in eine andere einfügen:

      include :: somefile.adoc

      Dies ist nicht anders als bei Master-Dokumenten in Textverarbeitungsprogrammen. Auf diese Weise können Sie beispielsweise jedes Kapitel als separate Datei erstellen “umfassen” alle in einer Datei, die das Buch darstellt. Wenn du das verarbeitest “Buchdatei,” Die Ausgabe wird so aussehen, als ob alle Kapitel direkt in dieses Dokument geschrieben wurden.

      Markdown ist genug für die meisten Benutzer

      Markdown deckt alle Grundlagen für einen größeren Teil der Benutzer ab. Für diejenigen, die nur nach einem Blog suchen oder einige Notizen in einem einfachen Textformat eingeben, unterstützt Markdown alle Elemente, die sie benötigen. Querverweise bedeuten nicht viel für einen Benutzer, der nur ein einfaches Memo oder eine Webseite erstellen möchte. Sie können Markdown sogar für längere Arbeiten mit einfachen Layouts verwenden, z. B. einem Roman "Who Needs Scrivener". 5 Neuartige Apps für Linux schreiben Wer braucht Scrivener? 5 Neuartige Apps für Linux Scrivener gibt es nicht für Linux. Wie werden Sie also verfolgen, wo sich diese Charaktere befinden, was sie getan haben und wie sie ihre Reise abschließen? Nun, eines dieser Tools sollte helfen. Lesen Sie mehr, und kombinieren Sie sie am Ende selbst.

      Markdown wird besser unterstützt

      Da Markdown die Anforderungen eines größeren Anwendersegments erfüllt, wurde es in Bezug auf Folgendes besser unterstützt:

      • WYSIWYG-Editoren (wie von denjenigen definiert, die zumindest eine Live-Vorschau bieten) unterstützen Markdown viel eher.
      • Online-Dienste wie der zuvor erwähnte Github akzeptieren Markdown eher direkt oder durch die Verwendung von Addons. 6 Markdown-Editoren, die mit Google Drive nett spielen 6 Markdown-Editoren, die mit Google Drive nett spielen Markdown ist das Textbearbeitungsformat der Zukunft. Es ist einfacher, schlanker und einfacher zu verwenden als HTML, ohne dass dabei viel Leistung oder Flexibilität einbüßt. Weiterlesen .
      • Veröffentlichungssysteme wie statische Site-Generatoren 7 Gründe, Ihr CMS aufzulösen und einen Generator für statische Sites in Betracht zu ziehen 7 Gründe, Ihr CMS aufzulösen und einen Generator für statische Sites in Betracht zu ziehen Für viele Benutzer war das Veröffentlichen einer Website viele Jahre lang schwierig. CMSs wie WordPress haben das geändert, aber sie können immer noch verwirrend sein. Eine andere Alternative ist ein statischer Standortgenerator. Lesen Sie mehr oft unterstützen Asciidoc mit Plugins, dass sie Markdown direkt unterstützen, ist fast eine Selbstverständlichkeit.

      Wollen Sie Asciidoc einmal ausprobieren??

      Während Markdown unter den leichtgewichtigen Markup-Sprachen eine faktische Wahl ist, enthält Asciidoc alle Elemente und einige. Die Extras von Asciidoc benötigen etwas Zeit zum Lernen, um Sie auf größere und komplexere Schreibprojekte vorzubereiten.

      Was denkst du? Sind Sie mit der Einfachheit von Markdown zufrieden? Oder ist die Erstellung eines eigenen Multi-Channel-Publishing-Workflows mit Asciidoc verlockend? Vielleicht hassen Sie Text und es ist für Sie ganz Word? Lass es uns in den Kommentaren wissen!

      Erfahren Sie mehr über: Markdown, Schreibtipps.