AsciiDoc

AsciiDoc este un open source, cross-platform și gratuit utilitar de linie de comandă implementat în Python ca un format de document text, care poate fi folosit de oricine care vrea să scrie pagini de manual, articole, documente scurte, precum și cărți pentru GNU lor / sisteme de operare Linux.

Fișierele generate cu software-ul AsciiDoc poate fi tradus în HTML (HyperText Markup Language), XHTML (Extensible Hypertext Markup Language) și DocBook marcaje, pur și simplu prin utilizarea & lsquo; & rsquo asciidoc; linie de comandă instrument (a se vedea secțiunea de început de asistent de mai jos pentru detalii).

Deoarece software-ul nu folosește notații format ciudate sau tag-uri markup, utilizatorii vor putea să scrie AsciiDoc documente în același mod în care ar scrie un document text obișnuit într-o aplicație Word ca

Pentru a instala și utiliza software-ul AsciiDoc pe distribuție GNU / Linux, va trebui să descărcați cea mai recentă versiune fie din proiect & rsquo; ul sau Softoware, salvați arhiva pe directorul de pornire, și despachetați-l folosind arhiva ta preferata utilitate manager.
Deschideți un instrument emulator de terminal, navigați la locația fișierelor arhivă extrase (de exemplu, cd /home/softoware/asciidoc-8.6.9), executați & lsquo; ./ configurare & amp; & amp; face & rsquo; comandă pentru a configura programul și de a construi executabilul, apoi executați & lsquo; sudo make install & rsquo; comanda să-l instalați.
După instalare, executați & lsquo; asciidoc help-rsquo; comandă pentru a vedea programul & rsquo; opțiunile de linie de comandă s mesaje de utilizare și disponibile, astfel încât să puteți învăța cum să-l folosească. Pentru o referință completă a comenzilor de marcare, ar trebui să citiți Ghidul utilizatorului AsciiDoc.

Fiind scris în Python, AsciiDoc este un software cross-platform care ruleaza pe orice distributie GNU / Linux. Acesta ar trebui să funcționeze, de asemenea, pe sistemele de operare Microsoft Windows și Mac OS X, și este acceptată în prezent pe platforme de calculatoare 32 și 64 de biți.

Ce este nou în această versiune:

• Completări și modificări:
• Implementarea unui stil float titlu. Un titlu plutitoare (sau cap de pod) devine la fel ca o secțiune normală, dar nu este asociată în mod oficial cu un corp de text și nu face parte din secțiunea ierarhiei regulat asa ca nu se aplică regulile obișnuite de comanda.
• Implementarea inline comentariu macro astfel linii de comentarii pot apărea acum în interiorul elementelor bloc.
• linii de comentarii sunt trimise la ieșirea daca showcomments atribut este definit (blocuri comentariu nu sunt trimise la ieșire).
• Singur valorile atributelor conține în elemente AttributeList să fie înlocuit ca textul linie normală determină (fără cita singur atribut doar substituție se efectuează).
• rescris prelucrare element din listă (era foarte crufty). Listă de continuare și lista de blocuri lucra acum cum era de așteptat. Documentație Lista actualizată și clarificată în Ghidul utilizatorului.
• Atributul de revizuire recunoaste acum formatul îi trimită RCS $ Id $.
• O RCS $ Id $ să îi trimită formatat linie de revizuire în antetul nu trebuie să fie precedată de o linie autor.
• Dacă o revizuire RCS $ Id $ formatat este specificat și numele autorului nu a fost deja stabilit apoi numele autorului în încadrare $ ID $ va fi folosit.
• Updated filtru Graphviz Gouichi Iisaka de la versiunea 1.1.3.
• Adaugata autowidth opțiune atribut de masă pentru iesiri (X) HTML.
• DocBook backend pune acum ORGNAME atribut opțional în afara DocBook.
• depreciată fără acte atribut CompanyName în favoarea corpname DocBook lui.
• Eliminat închidere explicit backslash de la HTML4 de auto-închidere tag-uri pentru a se conforma cu recomandarea WC3.
• Remedii erori:
• fix 8.3.3 regresie prin care listele adiacente cu aceeași sintaxă, dar diferite stiluri lista au fost tratați incorect ca o singură listă.

Ce este nou în versiunea 8.3.3:

• Remedii erori:
• numerotarea rupt și confuz și numeration2 numerotate lista de atribute au fost abandonat, folosiți atributul style în loc.

Ce este nou în versiunea 8.3.2:

• Completări și modificări:
• filtru Adaugat Gouichi Iisaka de Graphviz distribuției.
• Elementul SidebarBlock poate fi acum redat cu un stil abstract.
• filtre reorganizat într-un subdirector separat pentru fiecare filtru.
• Updated Makefile.in și MANIFEST fișierele, pentru a reflecta noua organizare filtre.
• Adăugat stil listarea la elementul LiteralBlock astfel anunt blocuri listare imbricate pot fi prestate ca un bloc listare.
• schimbată filtru exemplu cod pentru a utiliza preferat sintaxa ListingBlock (vechi sintaxa filtru ~ delimitat nu mai este utilizat).
• enumerare Implementarea si enumeration2 numerotate listă atribute pentru specificarea stilul de numerotare listă (arabică, loweralpha, upperalpha, lowerroman și upperroman).
• AsciiDoc upperalpha, lowerroman și numere upperroman în listdef-numbered2 liste numerotate recunoaste acum si stabileste stilul numărul bazat pe stilul de elementul din listă primul numerotate (alternativă la setarea atribut enumeration2).
• Updated formatlistpat definiție în exemplul .vimrc în Ghidul utilizatorului.
• Acum puteți evacuare backslash macro-uri bloc sistem.
• Adaugat Pychart FAQ.
• Arunca alineatul text și listă de text, index și eticheta meci grupuri din atributele - acestea sunt incluse în textul elementului și nu dorim să le procesate a doua oară ca atribute
.
• schimbată comentariu bloc de linii macro la un macro bloc passthrough pentru a asigura nu substituții.
• A subslist nu mai trebuie să fie anexată la o definiție macro PassthroughBlock, în cazul în care sunt efectuate omise nici substituții.
• Cod curețe: înlocuite operatorul depreciat cu =
!.
• cod linuxdoc nefolosit îndepărtat.
• Cod up ordonat: a scăzut tipuri vechi modul de referință; has_key înlocuit (), cu preferată în operatorul.
• Remedii erori:
• Old filtru a evidenția sursa sintaxă de regresie:. Caractere speciale în cazul în care nu au scăpat în ieșiri DocBook

Ce este nou în versiunea 8.3.1:

• Completări și modificări:
• Înlocuit scriptul install.sh cu script-uri autoconf actualizate Ben Walton lui -. A se vedea [1] INSTALL pentru detalii
• Adaugata o sintaxă AttributeEntry generalizată pentru a permite intrări de fișiere de configurare arbitrare să se stabilească din interiorul unui document de AsciiDoc (sugerat de Henrik Maier).
• Listarea blocuri delimitate în ieșiri DocBook susține acum acte de identitate; ID-uri de denumirea Firme si blocheaza literale delimitate au fost mutate la închidere exemplu eticheta DocBook (datorită Vijay Kumar pentru acest patch).
• Înlocuit apostrof mașină de scris vertical cu semne de punctuație apostrof (datorită Noe Slater).
• Remedii erori:
• regresie:. Fără ghilimele de valorile atributelor necotate a dus la incompatibilitate înapoi, ghilimele in valorile atributelor necotate a fost repus
• regresie: Text ca & amp; ...; a fost uneori confundat cu o trimitere entitate -. înăsprite potrivire referință entitate

Cerințe :

• Python