asciidoctor

Rédigé par Paulo Aucun commentaire
Classé dans : Linux Mots clés : asciidoctor




Asciidoctor

 

Asciidoctor : chaine de compilation de documents au format asciidoc

  • installation :
    yum install rubygem-asciidoctor
    yum install rubygem-coderay (3 paquets)

      
     

  • création dans un dossier du repertoire 'images/icons'
           - images pour déposer les eventuelles images de la doc (...)
           - icons pour onserver les icones (genre TIP : important, warning, ect...)
$ll images/icons/
   total 24K
   -rw-rw-r-- 1 paulo paulo 2,2K 22 mars  09:18 caution.png
   -rw-rw-r-- 1 paulo paulo 2,7K 22 mars  09:17 important.jpg
   -rw-rw-r-- 1 paulo paulo 3,0K 15 mars  10:39 important.png
   -rw-rw-r-- 1 paulo paulo 2,5K 15 mars  10:39 note.png
   -rw-rw-r-- 1 paulo paulo 4,8K 22 mars  09:18 warning.jpg

 

  • exemple de code (fichier exemple.adhoc) :
    #cat /tmp/exemple.adhoc
    :imagesdir: ./images
    :iconsdir: ./images/icons
    
    === Serveur Oracle :
    Le serveur Oracle doit etre installé sur un socle Linux CentOS image:centos_nous.png[Centos, 25, 25, link="http://centos.org"]
    [.lead]
    Permet d'installer le server Oracle en version 11.2.0.3, 11.2.0.4 et 12.1.0.2.
    
    image:centos_nous.png[Venezia, 50, 50, link="http://google.fr"]
    You can find Linux everywhere these days!
    
    IMPORTANT: Permet d'installer le server **Oracle** en version 11.2.0.3, 11.2.0.4 et 12.1.0.2.
     Ceci est important
    
    WARNING: Permet d'installer le server Oracle en version 11.2.0.3, 11.2.0.4 et 12.1.0.2.
    Ceci est une warning
    
    CAUTION: Permet d'installer le server Oracle en version 11.2.0.3, 11.2.0.4 et 12.1.0.2.
    Ceci est une caution
    
    image:centos.jpg[width=50, height=50, role="related thumb right"] Here's text that will wrap around the image to the left.
    
    .Attributs
    [format="csv",width="100%",cols="^1,^1,^3,^2",options="header"]
    |=========================================================
    Attribut,Obligatoire,Description,Exemple
    oracle,oui,version majeure,11204
    server,oui,version + release RPM Chapeau,11.2.0.4-2
    tools,oui,version + release RPM Chapeau oracle-tools,1.0-2.el7
    |=========================================================
    
    
    .Exemple de création du server Oracle
    [ source, python]
    ----
    dn:oracle=11204,ou=sgbd,cn=system01.test,ou=system,idPF=test
    objectClass: oracleServer
    objectClass: puppetMarker
    objectClass: top
    oracle: 11204
    server: 11.2.0.4-2
    tools: 1.0-1.el7
    ----
    [ source, python]
    from AbstractMapper import AbstractMapper
    
    class OracleServerMapper(AbstractMapper):
        def __init__(self, factory):
            AbstractMapper.__init__(self, factory, 'oracleServer', 'puppet_oracleserver')
    
        def setOracleServerConfig(self, config, _oracle, _server, _tools):
            if 'oracle' not in config['classes']:
                config['classes']['oracle'] = {}
    
            if 'server' not in config['classes']['oracle']:
                config['classes']['oracle']['server'] = {}
    
            if 'param' not in config['classes']['oracle']['server']:
                config['classes']['oracle']['server']['param'] = {}
    

     

 

  • génération du fichier en html
         asciidoctor -a source-highlighter=coderay -a icons  exemple.adoc

Les commentaires sont fermés.