Werbung

Wie Sie schon von früheren Artikeln gesehen haben, sind wir bei MakeUseOf Fans von Markdown What Is 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. Weiterlesen . Indem Sie dieses einfache und intuitive Format erlernen, können Sie einfach gut aussehende Ausgaben erstellen. Von PDFs zu Webseiten wird Ihre bescheidene, einfache Textdatei zu einem anspruchsvollen Dokument.

Aber Markdown ist nicht das einzige Spiel in der Stadt. Es gibt eine Reihe anderer sogenannter leichter Markup-Sprachen, die Markdown ähnlich sind, aber unterschiedliche Feature-Sets haben. Einer davon ist Asciidoc. Wenn Sie Markdown mögen, aber ein wenig mehr unter der Haube suchen, ist es eine Überlegung wert. Hier sind einige Gründe warum.

Was ist eine "Markup Language"?

Eine Markup-Sprache ist eine Gruppe von Codes, die es Ihnen ermöglichen, unter ansonsten einfachen Text eine oder mehrere der folgenden Eigenschaften hinzuzufügen:

• Definieren Sie den Text
• Strukturiere den Text
• Beschreiben Sie das Layout des Textes
• Dekoriere den Text

Eine Auszeichnungssprache, der Sie jeden Tag begegnen (außer Sie sind ein Einsiedler), ist Hypertext Markup Language oder HTML. Die Websites und Anwendungen, die Ihnen Nachrichten bringen und Ihnen Ihre E-Mails zeigen, sind zumindest teilweise mit HTML-Markup erstellt. Lernen Sie HTML und CSS mit diesen Schritt für Schritt Tutorials Lernen Sie HTML und CSS mit diesen Schritt für Schritt Tutorials Neugierig auf HTML, CSS und JavaScript? Wenn Sie glauben, dass Sie ein Händchen dafür haben, zu lernen, wie Sie Webseiten von Grund auf neu erstellen, sollten Sie hier einige Schritt-für-Schritt-Tutorials ausprobieren. Weiterlesen . HTML verwendet Tags als Mechanismus, um den unverarbeiteten Textinhalt zu markieren. Betrachten Sie zum Beispiel das folgende HTML-Snippet:

 Einführung in HTML 
Hier ist ein Absatz in HTML ... wir wissen, dass es ein Absatz ist, weil die umgebenden \ -Tags ihn als einen definieren.

Hier das

Tag gibt den gesamten folgenden Text bis zum Schließen an

Tag, ist ein Absatz. In diesem Sinne definiert es den Text als Absatz.

Beachten Sie aber auch die Tags ... diese dienen oft dazu, das Layout einer Webseite zu definieren, beispielsweise wie viel Rand von der Seite des Bildschirms entfernt ist.

Und die Tags werden das Wort "Absatz" in Fettschrift darstellen, während die

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

Das Problem mit einigen Markup-Sprachen (darunter HTML) ist, dass die manuelle Eingabe dieser Tags eine sehr langweilige Angelegenheit ist. Und mit anderen Sprachen wie XML Was ist eine XML-Datei und was sind ihre Verwendung? [Falls Sie sich Gedanken gemacht haben] Was ist eine XML-Datei und was werden sie benötigt? [Wenn Sie sich gefragt haben] Lesen Sie mehr, die Tags und ihre Attribute machen einen größeren Teil des gesamten Inhalts aus als der Text selbst! Sehen Sie sich das folgende DocBook-Snippet an, einen XML-Dialekt, der zum Erstellen vieler technischer Publikationen verwendet wird:

Der gesamte Text in lila stellt Tags dar, die Sie selbst eingeben müssen. Der erste Absatz beginnt erst am Ende dieses Bildes. Und wenn es nach dem DocBook-Standard nicht richtig gemacht wird, können Sie es nicht in das hübsche PDF-Dokument konvertieren, das normalerweise das Endziel ist.

Geben Sie die Lightweight Markup Language ein

Wenn Sie Markup-Sprachen nutzen möchten, indem Sie beispielsweise eine HTML-Seite im Web veröffentlichen oder eine DocBook-Datei in eine PDF-Datei konvertieren, um sie auszudrucken, müssen Sie zwei Dinge tun. Auf der einen Seite könnte man Zeit investieren, indem man diese Sprachen in- und auswendig lernt, sie von Hand schreibt und dann die Arbeit dreimal überprüft. Oder Sie könnten Geld in ein Tool investieren, das die Komplexität für Sie verwaltet.

Zum Glück haben einige unternehmungslustige Entwickler eine dritte Option gefunden. Sie erstellten neue Auszeichnungssprachen, die viele (in einigen Fällen die meisten oder alle) der Merkmale der schwereren Gegenstücke enthielten, aber die Syntax stark vereinfachten. Diese "leichten" Sprachen beinhalten 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, Emacs Org-Mode-Format und die Mediawiki-Syntax.

Leichte Markierungssprachen haben eine einfache Syntax

Ein Kennzeichen dieser Sprachen ist, dass ihre "Tags" (wie sie sind) intuitiv sein sollten. Werfen wir einen Blick auf das vorherige Snippet, das diesmal in Asciidoc geschrieben wurde:

 Introducing Asciidoc -------------------- Where are the *paragraph* tags? We dont need them... Asciidoc is smart enough to realize this is a paragraph! 

Viel besser lesbar, nicht? Beginnend an der Spitze können wir die Überschrift identifizieren, wie sie mit Bindestrichen "unterstrichen" ist. Sie könnten dies tun, wenn Sie Handschrift waren, zeichnen Sie einfach eine Unterstreichung unter dem Titel der Seite in Ihrem Notizbuch. Es gibt auch keine Absatztags - Asciidoc betrachtet alles zwischen zwei leeren Zeilen, die kein anderes Markup als "normalen" Absatztext haben. Schließlich zeigen die Sternchen um das Wort "Absatz" eine Fettschrift an. Heben Sie Ihre Hand, wenn Sie dies in einer Textnachricht getan haben, um genau dasselbe zu bedeuten.

Jeder hat einen oder mehrere entsprechende Prozessoren

Die "Schwergewicht" Markup-Sprachen haben in der Regel eine spezielle Anwendung, um sie für Sie zu interpretieren. Im Internet ist es Ihr Browser sowie möglicherweise der Webserver, der den Code in auffällige Webseiten verwandelt. Alles, was Sie über Content Management Systeme wissen müssen Alles, was Sie über Content Management Systems wissen müssen Für den durchschnittlichen Internet-Surfer, Inhalte anzeigen ist einfach. Sie öffnen einen Link und die Seite wird angezeigt. Aber was passiert hinter den Kulissen? So kümmern sich Ihre Lieblings-CMSs um Ihr Geschäft. Weiterlesen . Für Dokumente in XML könnte es so etwas wie Microsoft Word sein, das liest und schreibt es ist DOCX-Format Wie öffne ich Microsoft Word 2007 DOCX-Dateien Wie öffne ich Microsoft Word 2007 DOCX-Dateien Haben Sie jemals eine dieser Dateien mit der Erweiterung .docx und erhalten fragte sich was damit zu tun? Es kann nicht in älteren Word-Versionen angezeigt werden, also wie können Sie eine .docx-Datei öffnen ... Lesen Sie mehr (das ist ein anderer XML-Dialekt). Sie müssen also nie direkt mit der Quelle dieser Dokumente interagieren, sondern nur mit den schönen Fassaden, die Ihnen Ihre Apps zeigen.

Inzwischen sind Dokumente, die in leichtgewichtigen Sprachen geschrieben sind, in Quellform lesbar (ein anderer Mieter), aber nur wahre Nerds könnten denken, dass sie schön sind. Um eine schöne Ausgabe zu erhalten, müssen Sie einen Prozessor verwenden . Dies sind Anwendungen, die Zeile für Zeile durch Ihr Markup laufen und es in etwas anderes umwandeln, das gut aussieht. Die gleichen Projekte, die die Sprache selbst entwickeln, erzeugen in der Regel ein Dienstprogramm, um damit zu arbeiten. Das Markdown-Projekt bietet ein Perl-Skript mit demselben Namen, und Asciidocs Companion-Programm ist in Python geschrieben. Darüber hinaus enthalten andere Konvertierungsprogramme Unterstützung für einige dieser Sprachen. Ein solcher ist der ausgezeichnete Pandoc, wie man zwischen Dokumentformaten in Linux leicht umwandelt Wie man zwischen Dokumentenformat in Linux leicht umwandelt Das Wechseln zu Linux kann Probleme mit der Dateikompatibilität ergeben. Zum Beispiel sehen Dokumente in LibreOffice nicht gleich aus wie in Word. Dies ist nur ein Grund, warum Sie Pandoc brauchen. Lesen Sie mehr, die Markdown sowie leichte Markups ReStructured Text, Mediawiki und Org-Mode und konvertieren sie in PDF, DOCX, ODT und mehr.

Das Ergebnis ist, dass leichtgewichtige Markup-Sprachen es Ihnen ermöglichen, im Klartext zu arbeiten, dem tragbarsten Datenformat auf dem Planeten, und dennoch am Ende eine gut aussehende Ausgabe zu produzieren. Nun, da Sie von seinen Vorzügen überzeugt sind, welche Sprache sollten Sie wählen? Markdown ist zweifellos das beliebteste und hat seine Vorteile (mehr dazu später). Vor allem aber Asciidoc ist eine würdige Alternative. Im nächsten Abschnitt werden wir ein paar Gründe erforschen, warum.

Vergleichen Markdown und Asciidoc

Das Asciidoc-Format wurde entwickelt, um DocBook, eines der gebräuchlichsten Formate in der langen (insbesondere technischen) Schreibweise, leicht zu gestalten. Einer davon ist, dass es eine Eins-zu-Eins-Übersetzung ist, was bedeutet, dass für jedes Element in DocBook eine entsprechende Darstellung in Asciidoc vorhanden ist. Im Folgenden betrachten wir einige der Vor- und Nachteile von Asciidoc im Vergleich zu Markdown.

Asciidoc deckt ein Superset von Schreibelementen ab

Markdowns Ziel war es von Anfang an, ein einfaches Format für Web-Autoren zu sein. Daher sind die Schreibelemente, die es unterstützt (zumindest die ursprüngliche Implementierung, siehe unten), darauf ausgerichtet, die zeitintensiveren Aspekte des Schreibens von HTML zu automatisieren (zum Beispiel Listen, für die das

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

  

  Asciidoc enthält diese auch, bietet aber auch erweiterte DocBook-Elemente, wie zum Beispiel Admonitions (zB "Hinweis:" oder "Info:" Callout-Blöcke) und komplexe Tabellenlayouts. Es bedeutet nicht, dass Sie sie die ganze Zeit benutzen müssen, aber sie werden da sein und verfügbar sein, wenn Sie sie jemals brauchen.

  Asciidoc ist ein einheitliches Format

  Als die Popularität von Markdown begann, begannen einige seiner Benutzer, auf einige der oben diskutierten Mängel zu stoßen. Also begannen diese Benutzer, eigene Erweiterungen zu entwickeln, um diese Probleme zu lösen, wie die Möglichkeit, Tabellen oder Fuß- / Endnoten hinzuzufügen. Bald gab es viele "Aromen" von Markdown, darunter (ua):

  • Der von Github für die "Readme" -Dateien der von ihm gehosteten Projekte verwendete Geschmack.
  • Ein "erweiterter" Geschmack, der aus einem PHP-Port des originalen Markdown mit zusätzlichen HTML-bezogenen Funktionen hervorgegangen ist.
  • Ein Flavor mit dem Namen "MultiMarkdown", der viele Funktionen für das Schreiben längerer Schriften implementiert hat, einschließlich Zitaten, Definitionen und Querverweisen.

  Dies führt dazu, dass das Dokument möglicherweise Elemente erfordert, die nicht alle von einem einzigen Geschmack abgedeckt sind. Im Gegensatz dazu leidet Asciidoc nicht an der gleichen Fragmentierung, die Markdown derzeit hat.

  Asciidoc zielt auf eine Vielzahl von Veröffentlichungsstilen ab

  Markdown ist großartig, um schnell einen Blogpost aus deinem Kopf und auf die Seite zu bekommen. Aber es ist nicht für die Strukturierung längerer Arbeiten, wie ein Buch, geeignet. Asciidoc ist dafür ausgelegt, und ein Beispiel sind seine "include" -Funktionen. Mit diesen Anweisungen können Sie den gesamten Inhalt einer Datei in einen anderen einschließen:

   include::somefile.adoc 

  Dies ist nicht unähnlich wie Master-Dokumente in Textverarbeitungsprogrammen arbeiten. So können Sie beispielsweise jedes Kapitel als separate Datei erstellen und dann alle in eine Datei "einbeziehen", die das Buch darstellt. Wenn Sie diese "Buchdatei" bearbeiten, wird die Ausgabe so aussehen, als ob alle Kapitel direkt in dieses Dokument geschrieben würden.

  Markdown ist genug für die meisten Benutzer

  Markdown deckt alle Grundlagen für eine größere Anzahl von Benutzern ab. Für diejenigen, die einfach nur bloggen oder Notizen in einem einfachen Textformat eingeben möchten, unterstützt Markdown alle Elemente, die sie benötigen. Querverweise bedeuten nicht viel für einen Benutzer, der nur ein einfaches Memo oder eine einfache Webseite erstellen möchte. Sie könnten Markdown sogar für längere Arbeiten mit einfachen Layouts verwenden, wie zum Beispiel für einen Roman, der Scrivener benötigt? 5 Novel Writing Apps für Linux Wer braucht Scrivener? 5 Novell-Writing-Apps für Linux Scrivener ist nicht für Linux verfügbar - also, wie wirst du verfolgen, wohin diese Charaktere gehen, was sie getan haben und wie sie ihre Reise abgeschlossen haben? Nun, eines dieser Tools sollte helfen. Lesen Sie mehr und kombinieren Sie sie am Ende selbst.

  Markdown wird besser unterstützt

  Da Markdown die Bedürfnisse eines größeren Benutzersegments erfüllt, wurde es besser in folgenden Punkten unterstützt:

  • WYSIWYG-Editoren (wie sie von denen definiert werden, die mindestens eine Live-Vorschau bereitstellen) unterstützen Markdown sehr viel häufiger.
  • Online-Dienste, wie der oben erwähnte Github, akzeptieren Markdown eher direkt oder durch die Verwendung von Addons 6 Markdown-Editoren, die mit Google Drive gut spielen 6 Markdown-Editoren, die mit Google Drive Markdown spielen, ist das Textbearbeitungsformat der Zukunft. Es ist einfacher, schlanker und einfacher zu verwenden als HTML, ohne viel Leistung oder Flexibilität zu opfern. Weiterlesen .
  • Obwohl Sie Systeme wie statische Site-Generatoren veröffentlichen 7 Gründe, Ihr CMS abzulegen und einen statischen Site-Generator zu betrachten 7 Gründe, Ihr CMS abzulegen und einen statischen Site-Generator zu betrachten Viele Jahre lang war die Veröffentlichung einer Website für viele Benutzer schwierig. CMS wie WordPress haben das geändert, aber sie können immer noch verwirrend sein. Eine andere Alternative ist ein Static Site Generator. Lesen Sie weiter oft unterstützen Asciidoc mit Plugins, dass sie Markdown aus der Box unterstützen ist fast eine Selbstverständlichkeit.

  Sind Sie bereit, Asciidoc einen Versuch zu geben?

  Während Markdown bei leichten Markup-Sprachen eine de facto Wahl darstellt, enthält Asciidoc alle die gleichen Elemente und dann einige. Die Extras von Asciidoc erfordern etwas Zeit, um sich besser auf größere und komplexere Schreibprojekte vorzubereiten.

  Was denken Sie? Sind Sie zufrieden mit der Einfachheit von Markdown? Oder erstellen Sie Ihren eigenen Multi-Channel-Publishing-Workflow mit Asciidoc? Vielleicht hasst du reinen Text und es ist Word den ganzen Weg für dich? Lass es uns in den Kommentaren wissen!