AsciiDoc

AsciiDoc è un open source, cross-platform e senza utilità della riga di comando implementato in Python come formato di documento di testo, che può essere utilizzato da chiunque voglia scrivere pagine di manuale, articoli, documenti brevi, e libri per la loro GNU / sistemi operativi Linux.

I file generati con il software AsciiDoc possono essere tradotti in HTML (HyperText Markup Language), XHTML (Extensible Hypertext Markup Language) e DocBook markup, semplicemente utilizzando il & lsquo; asciidoc & rsquo; Strumento della riga di comando (vedere la sezione introduttiva sotto per i dettagli).

Dato che il software non utilizza notazioni formato strani o tag di marcatura, gli utenti saranno in grado di scrivere AsciiDoc documenta lo stesso modo in cui avrebbe scritto un documento di testo normale in un'applicazione Word come

Per installare e utilizzare il software AsciiDoc sulla propria distribuzione GNU / Linux, si dovrà scaricare l'ultima versione sia dal progetto & rsquo; s sito web o Softoware, salvare l'archivio nella directory Home, scompattarlo utilizzando l'archivio preferito utilità di gestione.
Aprire uno strumento emulatore di terminale, passare al percorso dei file di archivio estratti (ad esempio cd /home/softoware/asciidoc-8.6.9), eseguire il & lsquo; ./ configure & amp; & amp; fare & rsquo; comando per configurare il programma e costruire il file eseguibile, quindi eseguire il & lsquo; sudo make install & rsquo; comando per installarlo.
Dopo l'installazione, eseguire il & lsquo; asciidoc help & rsquo; comando per visualizzare il programma & rsquo; s messaggi utilizzo e disponibili le opzioni della riga di comando, in modo da poter imparare ad usarlo. Per un riferimento completo dei comandi di markup, si dovrebbe leggere la Guida AsciiDoc utente.

Essendo scritto in Python, AsciiDoc è un software cross-platform che funziona su qualsiasi distribuzione GNU / Linux. Dovrebbe anche funzionare su sistemi operativi Microsoft X Windows e Mac OS, ed è attualmente supportata su piattaforme a 32 e 64 bit.

Cosa c'è di nuovo in questa versione:

• Aggiunte e cambiamenti:
• Implementato uno stile float titolo. Un titolo galleggiante (o ponte) è reso come una sezione normale, ma non è formalmente associata con un corpo del testo e non fa parte della gerarchia sezione regolare così le normali regole di ordinamento non si applicano.
• Implementato commento macro inline così righe di commento ora possono apparire all'interno elementi di blocco.
• Le righe di commento vengono inviati all'uscita se attributo definito le showcomments (blocchi di commento vengono mai inviati all'uscita).
• singoli valori degli attributi di quotazione in elementi AttributeList loro di essere sostituito come normale testo inline causa (senza citare singolo attributo di sola sostituzione viene effettuata).
• Riscritta trasformazione elemento della lista (era molto crufty). Elenco di continuazione e Lista blocchi ora funzionano come previsto. Aggiornato e chiarito la documentazione elenco in Guida per l'utente.
• L'attributo di revisione riconosce ora il formato marcatore RCS $ Id $.
• Un indicatore formattato linea revisione RCS $ Id $ nell'intestazione non ha bisogno di essere preceduto da una linea di autore.
• Se si specifica una revisione RCS $ Id $ formattato e il nome dell'autore non è già stato impostato, verrà utilizzato il nome dell'autore nel $ Id $ marcatore.
• Aggiornamento filtro Graphviz di Gouichi Iisaka alla versione 1.1.3.
• Aggiunta opzione attributo tavolo autowidth per le uscite (X) HTML.
• DocBook backend ora mette orgname attributo opzionale in DocBook intestazione.
• Sconsigliata documentata attributo CompanyName a favore di corpname di DocBook.
• Rimosso chiusura esplicito backslash da HTML4 tag di chiusura automatica di rispettare raccomandazione WC3.
• Correzioni di bug:
• fissi 8.3.3 regressione in cui le liste adiacenti con la stessa sintassi, ma diversi stili di elenco sono stati erroneamente considerati come un unico elenco.

Cosa c'è di nuovo nella versione 8.3.3:

• Correzioni di bug:
• La numerazione rotto e confuso e numeration2 numerata attributi della lista sono stati eliminati, utilizzare l'attributo di stile invece.

Cosa c'è di nuovo nella versione 8.3.2:

• Aggiunte e cambiamenti:
• Filtro Graphviz di Aggiunto Gouichi Iisaka alla distribuzione.
• L'elemento SidebarBlock può essere reso con uno stile astratto.
• filtri riorganizzata in una sottodirectory separata per ogni filtro.
• Aggiornamento Makefile.in ei file manifesto per riflettere nuova organizzazione filtri.
• lista stile Aggiunto a elemento LiteralBlock così annunci con blocchi di quotazione annidati possono essere resi come un blocco elenco.
• Cambiato filtro esempio di codice per utilizzare la sintassi ListingBlock preferito (la vecchia sintassi del filtro ~ delimitato non è più utilizzato).
• enumerazione Implementata e enumeration2 elenco numerato attributi per specificare lo stile di elenco di numerazione (arabo, loweralpha, upperalpha, lowerroman e upperroman).
• AsciiDoc ora riconosce upperalpha, lowerroman e numeri upperroman in listdef-numbered2 elenchi numerati e imposta lo stile numero in base allo stile della voce di elenco prima numerata (alternativa all'impostazione dell'attributo enumeration2).
• Aggiornamento formatlistpat definizione esempio .vimrc in Guida per l'utente.
• È ora possibile fuga backslash macro blocco di sistema.
• Aggiunto Pychart FAQ.
• Goccia testo paragrafo e la lista di testo, indice e fiammifero etichetta gruppi da attributi - sono incluse nel testo dell'elemento e non vogliamo loro elaborati per la seconda volta come attributi
.
• Cambiato commento a blocco di linee macro a una macro blocco passthrough per garantire l'assenza sostituzioni.
• A subslist non deve più essere aggiunto a una definizione di macro PassthroughBlock, se vengono eseguite omessi senza sostituzioni.
• Codice riordinare: operatore deprecato sostituito con =
!.
• Rimosso codice linuxdoc inutilizzati.
• Codice ups ordinato: abbandonato vecchio tipo di riferimento del modulo; has_key sostituito () con preferito in dell'operatore.
• Correzioni di bug:
• Old filtro evidenziazione della sintassi fonte di regressione:. Caratteri speciali in cui non sono fuggiti in uscite DocBook

Cosa c'è di nuovo nella versione 8.3.1:

• Aggiunte e cambiamenti:
• Sostituito lo script install.sh con script autoconf aggiornati di Ben Walton -. Vedi [1] INSTALL per i dettagli
• aggiunta una sintassi AttributeEntry generalizzato per permettere voci del file di configurazione arbitrari per impostare all'interno di un documento AsciiDoc (suggerito da Henrik Maier).
• Listing blocchi delimitati in uscite DocBook ora supporta ID; ID di Listing titolata e blocchi delimitati letterali sono stati spostati al allegando esempio tag DocBook (grazie a Vijay Kumar per questa patch).
• Sostituito macchina da scrivere apostrofo verticale con punteggiatura apostrofo (grazie a Noah Slater).
• Correzioni di bug:
• Regressione:. Escludendo virgolette dai valori degli attributi non quotate determinato un'incompatibilità all'indietro, virgolette nei valori degli attributi non quotate è stato reintegrato
• Regression: Text come & amp; ...; era a volte scambiato per un riferimento di entità -. inasprito riferimento di entità corrispondente

Requisiti :

• Python