AsciiDoc

AsciiDoc ist ein Open Source, Cross-Plattform-und frei-Befehlszeilenprogramm in Python als Text-Dokument-Format, das von jedem, der Handbuchseiten, Artikel, kurze Dokumente schreiben möchte einsetzbar sind, und Bücher für ihre GNU / Linux Betriebssysteme.

Generierte Dateien HTML, XHTML und DocBook Markups
Asciidoc & rsquo;

Die mit der AsciiDoc Software erstellten Dateien können in HTML (Hypertext Markup Language), XHTML- (Extensible Hypertext Markup Language) und DocBook Markups, einfach mit dem & lsquo übersetzt werden; Befehlszeilentool (siehe Abschnitt Erste Schritte unten für Details).

Sie können ganz einfach zu schreiben AsciiDoc Dokumente

Da die Software keine seltsamen Format Notationen oder Markup-Tags verwendet, werden die Nutzer in der Lage, AsciiDoc schreiben dokumentiert die gleiche Art und Weise, sie würden einen normalen Text-Dokument in ein Word-ähnliche Anwendung zu schreiben

Erste Schritte mit AsciiDoc begonnen
S Website oder Softoware, speichern Sie das Archiv auf Ihrem Home-Verzeichnis, und entpacken Sie es mit Ihrem Lieblings-Archiv;

So installieren und verwenden Sie die AsciiDoc Software auf Ihrem GNU / Linux Distribution, müssen Sie die neueste Version von entweder dem Projekt & rsquo downloaden Manager-Dienstprogramm.
Öffnen Sie ein Terminal-Emulator-Tool, navigieren Sie zum Speicherort der extrahierten Archivdateien (zB cd /home/softoware/asciidoc-8.6.9), führen Sie die & lsquo; ./ configure & amp; & amp; stellen & rsquo; Befehl, um das Programm zu konfigurieren und bauen Sie die ausführbare, dann führen Sie die & lsquo; sudo make install & rsquo; Befehl, es zu installieren.
Nach der Installation starten Sie das & lsquo; asciidoc --help & rsquo; Befehl, um das Programm & rsquo zu sehen; s Bedienungshinweis und verfügbaren Befehlszeilenoptionen, so können Sie lernen, wie man es benutzt. Eine vollständige Referenz der Markup-Befehle, sollten Sie die AsciiDoc Benutzerhandbuch zu lesen.

Läuft auf GNU / Linux, Windows und Mac

Das in Python geschrieben ist AsciiDoc ein Cross-Plattform-Software, die auf jedem GNU / Linux Distribution läuft. Es sollte auch auf den Microsoft Windows und Mac OS X-Betriebssystemen arbeiten, und es ist derzeit auf 32 und 64-Bit-Plattformen unterstützt.

Was ist neu in dieser Pressemitteilung:

• Ergänzungen und Änderungen:
• Implementiert einen Titel float-Stil. Eine schwimmende Titel (oder Brückenkopf) wird wie ein normaler Abschnitt wiedergegeben, ist aber nicht offiziell mit einem Text-Körper verbunden sind und ist nicht Teil des regulären Abschnitt Hierarchie, so dass die normale Bestellung Regeln nicht gelten.
• Implementiert Inline Kommentar Makro so Kommentarzeilen können nun innerhalb Blockelemente angezeigt.
• Kommentarzeilen sind mit dem Ausgang gesendet, wenn die showcomments Attribut definiert ist (Kommentar Blöcke werden nie an den Ausgang gesendet).
• Einzel Angabe von Attributwerten in Attributeelemente bewirkt, dass sie wie normale Inline-Text ersetzt werden (ohne Einzel zitieren Attribut Substitution durchgeführt wird).
• Schrieb Listenelement Verarbeitung (sehr crufty). Liste Fortsetzung und Liste Blöcke jetzt wie erwartet. Aktualisiert und geklärt Liste Dokumentation im Benutzerhandbuch.
• Die Überarbeitung Attribut erkennt nun die RCS $ Id $ Marker-Format.
• Ein RCS $ Id $ Marker formatiert Revision Linie in der Kopfzeile muss nicht von einem Autor Zeile vorangestellt werden.
• Wenn ein RCS $ Id $ formatiert Revision angegeben ist und der Name des Autors nicht bereits eingestellt wurde der Name des Autors in der $ Id $ Marker verwendet werden.
• Aktualisiert Gouichi Iisaka die Graphviz Filter auf Version 1.1.3.
• AUTOBREITE Tabellenattribut Option für (X) HTML-Ausgänge hinzugefügt.
• DocBook Backend setzt jetzt orgname optionales Attribut in DocBook-Header.
• Veraltete undokumentierte Firmenname Attribut für DocBook zu corpname.
• Entfernt explizite Schließen Backslash aus HTML4 selbstschließenden Tags mit WC3 Empfehlung entsprechen.
• Fehlerbehebungen:
• Feste 8.3.3 Regression wobei benachbarte Listen mit derselben Syntax aber unterschiedliche Listenstile wurden fälschlicherweise als einzige Liste behandelt.

Was ist neu in Version 8.3.3:

• Fehlerbehebungen:
• Die gestrichelte und verwirrend Nummerierung und numeration2 nummerierte Liste Attribute wurden fallen gelassen, mit dem Attribut style statt.

Was ist neu in Version 8.3.2:

• Ergänzungen und Änderungen:
• hinzugekommen Gouichi Iisaka die Graphviz Filter bis zum Vertrieb.
• Die SidebarBlock Element kann nun mit einem abstrakten Stil gerendert werden.
• Reorganisiert Filter in einem separaten Unterverzeichnis für jeden Filter.
• Aktualisiert Makefile.in und MANIFEST-Dateien, um neue Filter Organisation widerspiegeln.
• hinzugekommen Auflistung Stil LiteralBlock Element so Inserate mit verschachtelten Liste Blöcke können als Liste Block gemacht werden.
• Geänderte Beispielcode Filter zu bevorzugen ListingBlock Syntax (die alte ~ begrenzt Filtersyntax wird nicht mehr verwendet). Verwenden
• Implementiert Aufzählung und enumeration2 nummerierte Liste Attribute zur Angabe der Liste Nummerierungsstil (arabisch, Lower, Upperalpha, lowerroman und upperroman).
• AsciiDoc erkennt nun Upperalpha, lowerroman und upperroman Zahlen in listdef-numbered2 nummerierte Listen und legt die Anzahl Stil auf der Grundlage der Stil der ersten nummerierten Liste (Alternative zum Einstellen enumeration2 Attribut).
• formatlistpat Definition in .vimrc Beispiel in User Guide aktualisiert.
• Sie können jetzt als Escape-Systembaustein-Makros.
• hinzugekommen Pychart FAQ.
• Drop Absatztext und Listentext, Index und Etikett Spiel Gruppen von Eigenschaften - sie sind im Text des Elements enthalten, und wir wollen nicht, dass sie ein zweites Mal verarbeitet als Attribute
.
• geändert Kommentarzeile Block Makro einer Passthrough-Block Makro keine Substitutionen zu gewährleisten.
• Ein subslist muss nicht mehr auf eine PassthroughBlock Makrodefinition angehängt werden, wenn sie weggelassen keine Ersetzungen durchgeführt werden.
• -Code aufräumen: ersetzt veraltet Bediener =
!.
• Entfernt ungenutzte linuxdoc Code.
• -Code ordentlich ups: sank alten Typen Modulreferenz; ersetzt has_key () mit in Betreiber bevorzugt.
• Fehlerbehebungen:
• Alte Syntax Quelle Highlight Filter Regression:. Sonderzeichen, wenn nicht in DocBook Ausgänge entkommen

Was ist neu in Version 8.3.1:

• Ergänzungen und Änderungen:
• Ersetzt das Skript install.sh mit Ben Walton aktualisiert autoconf Skripte -. Siehe [1] INSTALLIEREN für Details
• Es wurde eine generali AttributeEntry Syntax, damit beliebige Konfigurationsdatei Einträge innerhalb einer AsciiDoc Dokument (von Henrik Maier vorgeschlagen) eingestellt werden.
• Listing begrenzt Blöcke in DocBook Ausgänge nun IDs zu unterstützen; IDs von Titel Listing und Wörtliche begrenzt Blöcke an den umschließenden DocBook Beispiel-Tag verschoben (dank Vijay Kumar für diesen Patch).
• Ersetzte vertikale Schreibmaschine Apostroph mit Satzzeichen Apostroph (dank Noah Slater).
• Fehlerbehebungen:
• Regression:. Ohne Anführungszeichen von nicht börsennotierten Attributwerte führte Abwärtsinkompatibilitäts, Anführungszeichen in nicht börsennotierte Attributwerten wurde wieder
• Regression: Text wie & amp; ...; war manchmal für eine Entity-Referenz -. bis Entitätsverweis Anpassung verschärft

Anforderungen :

• Python