asciidoctor 1.5.4 → 1.5.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 535a8de8deadb9acd40a7d412f1e148ef33cd5d6
-  data.tar.gz: 3706223606515ac060f8a2078b3d796719bdef26
+  metadata.gz: df2c7e4f13f4dd3005683aacb5ba5c82f66cbb95
+  data.tar.gz: 0166c918b333decd7eaac636c6c738916740a1da
 SHA512:
-  metadata.gz: 08ba16f2d379ae31508ee3f1963a45c078e4ce8dd20adf106df02f35ac89e0161a1253adbc4313baf4149cab5e7c9b8fb5f1ee2c53c57e844e3f0457b221b4e1
-  data.tar.gz: a5292f0b48dcbee18188b2f0de51bd3306fbed3aa09b1b0a647f00df00f01c74510878b0161b3c25ca1d1c983cf6645cd7e07e61a03a13dba41536327fb623c0
+  metadata.gz: 591fc288faff0a883162d38264a7a6a3ce3c9c5e9453cd164b58136e146806f233cf7c41b5046104be07fe2d348fd6528e357940602fbf1faa8571f5bceca410
+  data.tar.gz: e5264cf1ec776cf8af7941d835cf4067534e07f80f4da77924c778c81c7f54042e34577eb569e8f1dc0b845aa7dc133645ec1ec3372e70ccf938ac417c37cabf

data/CHANGELOG.adoc

@@ -1,6 +1,8 @@
 = Asciidoctor Changelog
-:uri-asciidoctor: https://github.com/asciidoctor/asciidoctor
-:uri-asciidoc: http://asciidoctor.org/docs/what-is-asciidoc
+:uri-asciidoctor: http://asciidoctor.org
+:uri-asciidoc: {uri-asciidoctor}/docs/what-is-asciidoc
+:uri-repo: https://github.com/asciidoctor/asciidoctor
+:icons: font
 :star: icon:star[role=red]
 ifndef::icons[]
 :star: ★
@@ -9,9 +11,73 @@ endif::[]
 {uri-asciidoctor}[Asciidoctor] is a _fast_, open source text processor and publishing toolchain for converting {uri-asciidoc}[AsciiDoc] content into HTML5, DocBook 5 (or 4.5) and other formats.
 
 This document provides a high-level view of the changes introduced in Asciidoctor by release.
-For a detailed view of what has changed, refer to the https://github.com/asciidoctor/asciidoctor/commits/master[commit history] on GitHub.
+For a detailed view of what has changed, refer to the {uri-repo}/commits/master[commit history] on GitHub.
 
 // tag::compact[]
+== 1.5.5 (2016-10-05) - @mojavelinux
+
+Enhancements::
+  * Add preference to limit the maximum size of an attribute value (#1861)
+  * Honor SOURCE_DATE_EPOCH environment variable to accomodate reproducible builds (@JojoBoulix) (#1721)
+  * Add reversed attribute to ordered list if reversed option is enabled (#1830)
+  * Add support for additional docinfo locations (e.g., :header)
+  * Configure default stylesheet to break monospace word if exceeds length of line; add roles to prevent breaks (#1814)
+  * Introduce translation file for built-in labels (@ciampix)
+  * Provide translations for built-in labels (@JmyL - kr, @ciampix - it, @ivannov - bg, @maxandersen - da, @radcortez - pt, @eddumelendez - es, @leathersole - jp, @aslakknutsen - no, @shahryareiv - fa, @AlexanderZobkov - ru, @dongwq - zh, @rmpestano - pt_BR, @ncomet - fr, @lgvz - fi, @patoi - hu, @BojanStipic - sr, @fwilhe - de, @rahmanusta - tr, @abelsromero - ca, @aboullaite - ar, @roelvs - nl)
+  * Translate README to Chinese (@diguage)
+  * Translate README to Japanese (@Mizuho32)
+
+Improvements::
+  * Style nested emphasized phrases properly when using default stylesheet (#1691)
+  * Honor explicit table width even when autowidth option is set (#1843)
+  * Only explicit noheader option on table should disable implicit table header (#1849)
+  * Support docbook orient="land" attribute on tables (#1815)
+  * Add alias named list to retrieve parent List of ListItem
+  * Update push_include method to support chaining (#1836)
+  * Enable font smoothing on Firefox on OSX (#1837)
+  * Support combined use of sectanchors and sectlinks in HTML5 output (#1806)
+  * fix API docs for find_by
+  * Upgrade to Font Awesome 4.6.3 (@allenan, @mogztter) (#1723)
+  * README: add install instructions for Alpine Linux
+  * README: Switch yum commands to dnf in README
+  * README: Mention Mint as a Debian distro that packages Asciidoctor
+  * README: Add caution advising against using gem update to update a system-managed gem (@oddhack)
+  * README: sync French version with English version (@flashcode)
+  * Add missing endline after title element when converting open block to HTML
+  * Move list_marker_keyword method from AbstractNode to AbstractBlock
+  * Rename definition list to description list internally
+
+Compliance::
+  * Support 6-digit decimal char refs, 5-digit hexidecimal char refs (#1824)
+  * Compatibility fixes for Opal
+  * Check for number using Integer instead of Fixnum class for compatibility with Ruby 2.4
+
+Bug fixes::
+  * Use method_defined? instead of respond_to? to check if method is already defined when patching (#1838)
+  * Fix invalid conditional in HTML5 converter when handling of SVG
+  * Processor#parse_content helper no longer shares attribute list between blocks (#1651)
+  * Fix infinite loop if unordered list marker is immediately followed by a dot (#1679)
+  * Don't break SVG source when cleaning if svg start tag name is immediately followed by endline (#1676)
+  * Prevent template converter from crashing if .rb file found in template directory (#1827)
+  * Fix crash when generating section ID when both idprefix & idseparator are blank (#1821)
+  * Use stronger CSS rule for general text color in Pygments stylesheet (#1802)
+  * Don't duplicate forward slash for path relative to root (#1822)
+
+Infrastructure::
+  * Build gem properly in the absense of a git workspace, make compatible with JRuby (#1779)
+  * Run tests in CI using latest versions of Ruby, including Ruby 2.3 (@ferdinandrosario)
+
+Distribution Packages::
+
+  * http://rubygems.org/gems/asciidoctor[RubyGem (asciidoctor)]
+  * https://apps.fedoraproject.org/packages/rubygem-asciidoctor[Fedora (rubygem-asciidoctor)]
+  * http://packages.debian.org/sid/asciidoctor[Debian (asciidoctor)]
+  * http://packages.ubuntu.com/saucy/asciidoctor[Ubuntu (asciidoctor)]
+
+https://github.com/asciidoctor/asciidoctor/issues?q=milestone%3Av1.5.5[issues resolved] |
+https://github.com/asciidoctor/asciidoctor/releases/tag/v1.5.5[git tag] |
+https://github.com/asciidoctor/asciidoctor/compare/v1.5.4...v1.5.5[full diff]
+
 == 1.5.4 (2016-01-03) - @mojavelinux
 
 Enhancements::
@@ -100,7 +166,7 @@ Improvements::
   * restore attributes to header attributes after parse (#1255)
   * allow docdate and doctime to be overridden (#1495)
   * add CSS class `.center` for center block alignment (#1456)
-  * recognize U+2022 as alternative marker for unordered lists (@mogztter) (#1177)
+  * recognize U+2022 (bullet) as alternative marker for unordered lists (@mogztter) (#1177)
   * allow videos to work for local files by prepending asset-uri-scheme (Chris) (#1320)
   * always assign playlist param when loop option is enabled for YouTube video
   * parse isolated version in revision line (@bk2204) (#790)
@@ -125,6 +191,7 @@ Improvements::
   * fix `+--help+` output text for `-I` (@bk2204)
   * don't require open-uri-cached if already loaded
   * do not attempt to scan pattern of non-existent directory in template converter
+  * prevent CodeRay from bolding every 10th line number
 
 Compliance::
   * use `<sup>` for footnote reference in text instead of `<span>` (#1523)
@@ -177,6 +244,7 @@ Distribution Packages::
 https://github.com/asciidoctor/asciidoctor/issues?q=milestone%3Av1.5.3[issues resolved] |
 https://github.com/asciidoctor/asciidoctor/releases/tag/v1.5.3[git tag] |
 https://github.com/asciidoctor/asciidoctor/compare/v1.5.2...v1.5.3[full diff]
+// end::compact[]
 
 == 1.5.2 (2014-11-27) - @mojavelinux
 
@@ -231,7 +299,6 @@ Distribution Packages::
 https://github.com/asciidoctor/asciidoctor/issues?q=milestone%3Av1.5.2[issues resolved] |
 https://github.com/asciidoctor/asciidoctor/releases/tag/v1.5.2[git tag] |
 https://github.com/asciidoctor/asciidoctor/compare/v1.5.1...v1.5.2[full diff]
-// end::compact[]
 
 == 1.5.1 (2014-09-29) - @mojavelinux
 

data/CONTRIBUTING.adoc

@@ -38,12 +38,12 @@ An ideal bug report would include a pull request with failing specs.
 . {uri-branch-help}[Create a topic branch] (preferably using the pattern `issue-XYZ`, where `XYZ` is the issue number).
 . Add tests for your unimplemented feature or bug fix. (See <<writing-and-executing-tests>>)
 . Run `bundle exec rake` to run the tests.
-If your tests pass, return to step 3.
+If your tests pass, return to step 4.
 . Implement your feature or bug fix.
 . Run `bundle exec rake` to run the tests.
-If your tests fail, return to step 5.
+If your tests fail, return to step 6.
 . Add documentation for your feature or bug fix.
-. If your changes are not 100% documented, go back to step 7.
+. If your changes are not 100% documented, go back to step 8.
 . Add, commit, and push your changes.
 . {uri-pr-help}[Submit a pull request].
 

data/Gemfile

@@ -0,0 +1,23 @@
+source 'https://rubygems.org'
+
+# Look in asciidoctor.gemspec for runtime and development dependencies
+gemspec
+
+# enable this group to use Guard for continuous testing
+# after removing comments, run `bundle install` then `guard` 
+#group :guardtest do
+#  gem 'guard'
+#  gem 'guard-test'
+#  gem 'libnotify'
+#  gem 'listen', :github => 'guard/listen'
+#end
+
+group :ci do
+  gem 'simplecov', '~> 0.9.1'
+  if ENV['SHIPPABLE']
+    gem 'simplecov-csv', '~> 0.1.3'
+    gem 'ci_reporter', '~> 2.0.0'
+    gem 'ci_reporter_minitest', '~> 1.0.0'
+    #gem 'ci_reporter_cucumber', '~> 1.0.0'
+  end
+end

data/README-fr.adoc

@@ -0,0 +1,416 @@
+= Asciidoctor
+Dan Allen <https://github.com/mojavelinux[@mojavelinux]>; Sarah White <https://github.com/graphitefriction[@graphitefriction]>; Ryan Waldron <https://github.com/erebor[@erebor]>
+// FIXME use build system to expand includes statically so document renders properly on GitHub
+ifeval::[{safe-mode-level} < 20]
+include::_settings-README.adoc[]
+endif::[]
+ifeval::[{safe-mode-level} >= 20]
+// settings:
+:page-layout: base
+:idprefix:
+:idseparator: -
+:source-language: ruby
+:language: {source-language}
+ifdef::env-github[:status:]
+// URIs:
+:uri-org: https://github.com/asciidoctor
+:uri-repo: {uri-org}/asciidoctor
+:uri-asciidoctorj: {uri-org}/asciidoctorj
+:uri-asciidoctorjs: {uri-org}/asciidoctor.js
+:uri-project: http://asciidoctor.org
+ifdef::env-site[:uri-project: link:]
+:uri-docs: {uri-project}/docs
+:uri-news: {uri-project}/news
+:uri-manpage: {uri-project}/man/asciidoctor
+:uri-issues: {uri-repo}/issues
+:uri-contributors: {uri-repo}/graphs/contributors
+:uri-rel-file-base: link:
+:uri-rel-tree-base: link:
+ifdef::env-site[]
+:uri-rel-file-base: {uri-repo}/blob/master/
+:uri-rel-tree-base: {uri-repo}/tree/master/
+endif::[]
+:uri-changelog: {uri-rel-file-base}CHANGELOG.adoc
+:uri-contribute: {uri-rel-file-base}CONTRIBUTING.adoc
+:uri-license: {uri-rel-file-base}LICENSE.adoc
+:uri-tests: {uri-rel-tree-base}test
+:uri-discuss: http://discuss.asciidoctor.org
+:uri-irc: irc://irc.freenode.org/#asciidoctor
+:uri-rubygem: https://rubygems.org/gems/asciidoctor
+:uri-what-is-asciidoc: {uri-docs}/what-is-asciidoc
+:uri-user-manual: {uri-docs}/user-manual
+:uri-install-docker: https://github.com/asciidoctor/docker-asciidoctor
+//:uri-install-doc: {uri-docs}/install-toolchain
+:uri-install-osx-doc: {uri-docs}/install-asciidoctor-macosx
+:uri-render-doc: {uri-docs}/render-documents
+:uri-themes-doc: {uri-docs}/produce-custom-themes-using-asciidoctor-stylesheet-factory
+:uri-gitscm-repo: https://github.com/git/git-scm.com
+:uri-prototype: {uri-gitscm-repo}/commits/master/lib/asciidoc.rb
+:uri-freesoftware: https://www.gnu.org/philosophy/free-sw.html
+:uri-foundation: http://foundation.zurb.com
+:uri-tilt: https://github.com/rtomayko/tilt
+:uri-ruby: https://ruby-lang.org
+// images:
+:image-uri-screenshot: https://raw.githubusercontent.com/asciidoctor/asciidoctor/master/screenshot.png
+endif::[]
+
+{uri-project}/[Asciidoctor] est un processeur de texte _rapide_ et une chaîne de publication pour convertir du contenu {uri-what-is-asciidoc}[AsciiDoc] en HTML5, DocBook 5 (ou 4.5) et d'autres formats.
+Asciidoctor est écrit en Ruby, packagé sous forme de RubyGem et publié sur {uri-rubygem}[RubyGems.org].
+La gemme est aussi incluse dans plusieurs distributions Linux, dont Fedora, Debian et Ubuntu.
+Asciidoctor est open source, {uri-repo}[hébergé sur GitHub] et distribué sous {uri-license}[licence MIT].
+
+ifndef::env-site[]
+.Ce document est traduit dans les langues suivantes :
+* {uri-rel-file-base}README.adoc[Anglais]
+* {uri-rel-file-base}README-zh_CN.adoc[Chinois]
+* {uri-rel-file-base}README-jp.adoc[Japonais]
+endif::[]
+
+.Documentation clé
+[.compact]
+* {uri-docs}/what-is-asciidoc[Qu'est ce qu'AsciiDoc ?]
+* {uri-docs}/asciidoc-writers-guide[Guide pour Rédacteur AsciiDoc]
+* {uri-docs}/asciidoc-syntax-quick-reference[Syntaxe de Référence AsciiDoc]
+* {uri-docs}/user-manual[Manuel Utilisateur Asciidoctor]
+
+.Asciidoctor est disponible partout où Ruby est disponible
+****
+Vous pouvez exécuter Asciidoctor dans la JVM en utilisant JRuby.
+Pour invoquer l'API Asciidoctor directement depuis Java ou d'autres langages de la JVM, utilisez {uri-asciidoctorj}[AsciidoctorJ].
+Des plugins basés sur AsciidoctorJ permettent d'intégrer le processeur Asciidoctor avec Apache Maven, Gradle ou Javadoc.
+
+Asciidoctor s'exécute également au sein de JavaScript.
+Nous utilisons http://opalrb.org[Opal] pour transcrire le code source Ruby en JavaScript afin de produire {uri-asciidoctorjs}[Asciidoctor.js], une version pleinement fonctionnelle d'Asciidoctor qui s'intègre dans tout environnement JavaScript, comme un navigateur web ou Node.js.
+Asciidoctor.js est utilisé pour faire fonctionner les extensions AsciiDoc Preview pour Chrome, Atom, Brackets et autres outils web.
+****
+
+ifdef::status[]
+.*Santé du projet*
+image:https://img.shields.io/travis/asciidoctor/asciidoctor/master.svg[Build Status (Travis CI), link=https://travis-ci.org/asciidoctor/asciidoctor]
+image:https://ci.appveyor.com/api/projects/status/ifplu67oxvgn6ceq/branch/master?svg=true&amp;passingText=green%20bar&amp;failingText=%23fail&amp;pendingText=building%2E%2E%2E[Build Status (AppVeyor), link=https://ci.appveyor.com/project/asciidoctor/asciidoctor]
+//image:https://img.shields.io/coveralls/asciidoctor/asciidoctor/master.svg[Coverage Status, link=https://coveralls.io/r/asciidoctor/asciidoctor]
+image:https://codeclimate.com/github/asciidoctor/asciidoctor/badges/gpa.svg[Code Climate, link="https://codeclimate.com/github/asciidoctor/asciidoctor"]
+image:https://inch-ci.org/github/asciidoctor/asciidoctor.svg?branch=master[Inline docs, link="https://inch-ci.org/github/asciidoctor/asciidoctor"]
+endif::[]
+
+== En un mot
+
+Asciidoctor lit du contenu écrit en texte brut, comme présenté dans la partie gauche de l'image ci-dessous, et le convertit en HTML5, comme présenté dans la partie droite.
+Asciidoctor applique une feuille de style par défaut au document HTML5 afin de fournir une expérience de lecture agréable, clé en main.
+
+image::{image-uri-screenshot}[Prévisualisation d'une source AsciiDoc et le rendu HTML correspondant]
+
+== Le traitement d'AsciiDoc
+
+Asciidoctor lit et analyse la syntaxe du texte écrit en AsciiDoc afin de créer une représentation, sous forme d'arbre, à partir de laquelle des templates sont appliqués pour produire de l'HTML5, du DocBook 5 (ou 4.5).
+
+Vous avez la possibilité d'écrire votre propre convertisseur ou de fournir des templates supportant {uri-tilt}[Tilt] pour personnaliser le résultat généré ou pour produire des formats alternatifs.
+
+NOTE: Asciidoctor est un remplaçant du processeur AsciiDoc original écrit en Python (`asciidoc.py`).
+La suite de tests Asciidoctor possède {uri-tests}[> 1,600 tests] pour garantir la compatibilité avec la syntaxe AsciiDoc.
+
+En plus de la syntaxe AsciiDoc standard, Asciidoctor reconnaît des balises additionnelles ainsi que des options de formatage, comme les polices d'icônes (par exemple `+icon:fire[]+`) et des éléments d'interface (par exemple `+button:[Enregistrer]+`).
+Asciidoctor offre aussi un thème moderne et « responsive » basé sur {uri-foundation}[Foundation] pour styliser le document HTML5 généré.
+
+== Prérequis
+
+Asciidoctor fonctionne sur Linux, OS X (Mac), Windows et requiert une des implémentations suivantes :
+
+* MRI (Ruby 1.8.7, 1.9.3, 2.0, 2.1, 2.2 & 2.3)
+* JRuby (1.7 dans les modes Ruby 1.8 et 1.9, 9000)
+* Rubinius 2.2.x
+* Opal (JavaScript)
+
+Votre aide est appréciée pour tester Asciidoctor sur l'une de ces plateformes.
+Référez-vous au paragraphe <<Contributions>> si vous souhaitez vous impliquer dans ce projet.
+
+[CAUTION]
+====
+Si vous utilisez un environnement Windows dans une autre langue que l'anglais, vous pourriez tomber sur l'erreur `Encoding::UndefinedConversionError` lors du lancement d'Asciidoctor.
+Pour corriger ce problème, nous recommandons de changer la page de code en UTF-8 dans votre console :
+
+ chcp 65001
+
+Après ce changement, tous les maux de tête liés à l'Unicode seront derrière vous.
+Si vous utilisez un environnement de développement comme Eclipse, assurez-vous de définir l'encodage en UTF-8.
+Asciidoctor fonctionne mieux lorsque vous utilisez UTF-8 partout.
+====
+
+== Installation
+
+Asciidoctor peut être installé en utilisant la commande (a) `gem install`, (b) Bundler ou (c) les gestionnaires de paquets pour les distributions Linux populaires.
+
+TIP: L'avantage d'utiliser le gestionnaire de paquets pour installer la gemme est que l'installation englobe celle des librairies Ruby et RubyGems si elles ne sont pas déjà installés.
+L'inconvénient est que le paquet n'est pas forcément mis à jour immédiatement après la mise à disposition de la gemme.
+Si vous avez besoin de la dernière version, vous devez passer par la commande `gem`.
+
+=== (a) Installation de la gemme
+
+Ouvrir un terminal et taper (en excluant le `$`) :
+
+ $ gem install asciidoctor
+
+Si vous souhaitez installer une version pre-release (c'est-à-dire, une « release candidate »), utilisez :
+
+ $ gem install asciidoctor --pre
+
+.Mettre à jour votre installation
+[TIP]
+====
+Si vous avez une précédente version d'Asciidoctor installée, vous pouvez la mettre à jour en utilisant :
+
+ $ gem update asciidoctor
+
+Si vous installez une nouvelle version de la gemme en utilisant `gem install` au lieu de `gem update`, vous aurez plusieurs versions d'installées.
+Si c'est le cas, utilisez la commande gem suivante pour supprimer la vieille version :
+
+ $ gem cleanup asciidoctor
+====
+
+=== (b) Bundler
+
+. Créez un fichier Gemfile à la racine de votre projet (ou du répertoire courant)
+. Ajoutez la gemme `asciidoctor` dans votre fichier Gemfile comme ci-dessous :
++
+[source]
+----
+source 'https://rubygems.org'
+gem 'asciidoctor'
+# ou spécifier la version explicitement
+# gem 'asciidoctor', '1.5.4'
+----
+
+. Sauvegardez le fichier Gemfile
+. Ouvrez un terminal et installez la gemme en utilisant :
+
+ $ bundle
+
+Pour mettre à jour la gemme, spécifiez la nouvelle version dans le fichier Gemfile et exécutez `bundle` à nouveau.
+Utiliser `bundle update` *n*'est *pas* recommandé car les autres gemmes seront également mises à jour, ce qui n'est pas forcément le résultat voulu.
+
+=== (c) Gestionnaire de paquets Linux
+
+==== DNF (Fedora 21 ou supérieure)
+
+Pour installer la gemme sur Fedora 21 ou supérieure en utilisant dnf, ouvrez un terminal et tapez :
+
+ $ sudo dnf install -y asciidoctor
+
+Pour mettre à jour la gemme, utilisez :
+
+ $ sudo dnf update -y asciidoctor
+
+TIP: Votre système peut être configuré pour mettre à jour automatiquement les paquets rpm, auquel cas aucune action de votre part ne sera nécessaire pour mettre à jour la gemme.
+
+==== apt-get (Debian, Ubuntu, Mint)
+
+Pour installer la gemme sur Debian, Ubuntu ou Mint, ouvrez un terminal et tapez :
+
+ $ sudo apt-get install -y asciidoctor
+
+Pour mettre à jour la gemme, utilisez :
+
+ $ sudo apt-get upgrade -y asciidoctor
+
+TIP: Votre système peut être configuré pour mettre à jour automatiquement les paquets deb, auquel cas aucune action de votre part ne sera nécessaire pour mettre à jour la gemme.
+
+La version d'Asciidoctor installé par le gestionnaire de paquets (apt-get) peut ne pas correspondre à la dernière version d'Asciidoctor.
+Consultez le dépôt de paquets de votre distribution pour trouver quelle version est disponible par version de distribution.
+
+* https://packages.debian.org/search?keywords=asciidoctor&searchon=names&exact=1&suite=all&section=all[Paquet asciidoctor par version de Debian]
+* http://packages.ubuntu.com/search?keywords=asciidoctor&searchon=names&exact=1&suite=all&section=all[Paquet asciidoctor par version d'Ubuntu]
+* https://community.linuxmint.com/software/view/asciidoctor[Paquet asciidoctor par version de Mint]
+
+[CAUTION]
+====
+Il est déconseillé d'utiliser la commande `gem update` pour mettre à jour la gemme gérée par le gestionnaire de paquets.
+Le faire mettrait la système dans un état incohérent car le gestionnaire de paquets ne pourrait plus gérer les fichiers (qui sont installés dans /usr/local).
+En résumé, les gemmes du système doivent être gérées seulement par le gestionnaire de paquets.
+
+Si vous souhaitez utiliser une version d'Asciidoctor qui est plus récente que celle installée par votre gestionnaire de paquets, vous devriez utiliser http://rvm.io[RVM] pour installer Ruby dans votre répertoire personnel (dans votre espace utilisateur).
+Vous pouvez alors utiliser la commande `gem` pour installer ou mettre à jour la gemme Asciidoctor.
+En utilisant RVM, les gemmes sont installées dans un emplacement isolé du système.
+====
+
+==== apk (Alpine Linux)
+
+Pour installer la gemme sur Alpine Linux, ouvrez un terminal et tapez :
+
+ $ sudo apk add asciidoctor
+
+Pour mettre à jour la gemme, utilisez :
+
+ $ sudo apk add -u asciidoctor
+
+TIP: Votre système peut être configuré pour mettre à jour automatiquement les paquets apk, auquel cas aucune action de votre part ne sera nécessaire pour mettre à jour la gemme.
+
+=== Autres options d'installation
+
+* {uri-install-docker}[Installation d'Asciidoctor avec Docker]
+* {uri-install-osx-doc}[Installation d'Asciidoctor sur Mac OS X]
+// pour l'instant, l'entrée suivante est juste une répétition de l'information dans ce README
+//* {uri-install-doc}[Installation de l'outillage Asciidoctor]
+
+== Utilisation
+
+Si la gemme Asciidoctor s'est installée correctement, la ligne de commande (CLI) `asciidoctor` sera disponible dans votre PATH.
+Pour vérifier sa disponibilité, exécutez la commande suivante dans votre terminal :
+
+ $ asciidoctor --version
+
+Vous devriez voir les informations concernant la version d'Asciidoctor et celle de votre environnement Ruby s'afficher dans le terminal.
+
+[.output]
+....
+Asciidoctor 1.5.4 [http://asciidoctor.org]
+Runtime Environment (ruby 2.2.2p95 [x86_64-linux]) (lc:UTF-8 fs:UTF-8 in:- ex:UTF-8)
+....
+
+Asciidoctor fournit aussi une API.
+Cette API permet une intégration avec d'autres logiciels Ruby, comme Rails, Sinatra et GitHub, ainsi que d'autres langages comme Java (via {uri-asciidoctorj}[AsciidoctorJ]) ou JavaScript (via {uri-asciidoctorjs}[Asciidoctor.js]).
+
+=== Interface de Ligne de Commande (CLI)
+
+La commande `asciidoctor` vous permet d'invoquer Asciidoctor à partir de la ligne de commande (c'est-à-dire, un terminal).
+
+La commande suivante convertit le fichier README.adoc en HTML et sauvegarde le résultat dans le fichier README.html dans le même répertoire.
+Le nom du fichier HTML généré est tiré de celui du fichier source, l'extension a été changée pour `.html`.
+
+ $ asciidoctor README.adoc
+
+Vous pouvez contrôler le processeur Asciidoctor en ajoutant plusieurs paramètres, vous pouvez en apprendre plus sur ces derniers en utilisant la commande :
+
+ $ asciidoctor --help
+
+Par exemple, pour écrire le fichier dans un répertoire différent, utilisez :
+
+ $ asciidoctor -D output README.adoc
+
+La {uri-manpage}[page man] `asciidoctor` fournit une référence complète sur l'interface de ligne de commande.
+
+Référez-vous aux ressources suivantes pour en apprendre davantage sur la façon d'utiliser la commande `asciidoctor`.
+
+* {uri-render-doc}[Comment convertir un document ?]
+* {uri-themes-doc}[Comment utiliser la fabrique de feuilles de style Asciidoctor pour produire des thèmes personnalisés ?]
+
+=== API Ruby
+
+Pour utiliser Asciidoctor dans votre application, vous avez tout d'abord besoin de faire un « require » sur la gemme :
+
+[source]
+require 'asciidoctor'
+
+Vous pouvez ensuite convertir un fichier AsciiDoc en fichier HTML en utilisant :
+
+[source]
+Asciidoctor.convert_file 'README.adoc', to_file: true, safe: :safe
+
+WARNING: Quand vous utilisez Asciidoctor via l'API, le mode de sûreté par défaut est `:secure`.
+Dans le mode « secure », plusieurs fonctionnalités centrales sont désactivées, comme la directive `include`.
+Si vous souhaitez activer ces fonctionnalités, vous aurez besoin de définir explicitement le mode de sûreté avec une la valeur `:server` (recommandée) ou `:safe`.
+
+Vous pouvez aussi convertir une chaîne de texte en fragment HTML (pour une insertion dans une page HTML) en utilisant :
+
+[source]
+----
+content = '_Zen_ in the art of writing http://asciidoctor.org[AsciiDoc].'
+Asciidoctor.convert content, safe: :safe
+----
+
+Si vous voulez le document HTML complet, activez l'option `header_footer` comme ci-dessous :
+
+[source]
+----
+content = '_Zen_ in the art of writing http://asciidoctor.org[AsciiDoc].'
+html = Asciidoctor.convert content, header_footer: true, safe: :safe
+----
+
+Si vous avez besoin d'accéder au document analysé, vous pouvez séparer la conversion en deux étapes distinctes :
+
+[source]
+----
+content = '_Zen_ in the art of writing http://asciidoctor.org[AsciiDoc].'
+document = Asciidoctor.load content, header_footer: true, safe: :safe
+puts document.doctitle
+html = document.convert
+----
+
+Gardez en tête que si vous n'aimez pas le contenu généré par Asciidoctor, _vous pouvez le changer !_
+Asciidoctor supporte des convertisseurs personnalisés qui peuvent prendre en charge la conversion depuis le document analysé jusqu'au contenu généré.
+
+Une façon simple de personnaliser les morceaux de contenu générés est d'utiliser le convertisseur de template.
+Le convertisseur de template vous permet, en utilisant un template supporté par {uri-tilt}[Tilt], de prendre en charge la conversion de n'importe quel élément dans le document.
+
+Vous l'aurez compris, vous _pouvez_ complètement prendre le contrôle sur le contenu généré.
+Pour plus d'informations sur comment utiliser l'API ou personnaliser le contenu généré, référez-vous au {uri-user-manual}[manuel utilisateur].
+
+== Contributions
+
+Dans l'esprit du {uri-freesoftware}[logiciel libre], _tout le monde_ est encouragé à aider en vue d'améliorer le projet.
+Si vous découvrez des erreurs ou des oublis dans le code source, la documentation, ou le contenu du site web, s'il vous plaît n'hésitez pas à ouvrir un ticket ou une « pull request » avec un correctif.
+Les contributeurs et contributrices sont toujours les bienvenus !
+
+Voici quelques façons de contribuer :
+
+* en utilisant les versions prerelease (alpha, beta ou preview),
+* en rapportant des anomalies,
+* en suggérant de nouvelles fonctionnalités,
+* en écrivant ou éditant la documentation,
+* en écrivant des spécifications,
+* en écrivant du code -- _Aucun patch n'est trop petit_
+** corriger une coquille,
+** ajouter des commentaires,
+** nettoyer des espaces inutiles,
+** écrire des tests !
+* en refactorant le code,
+* en corrigeant des {uri-issues}[anomalies],
+* en effectuant des relectures des patches.
+
+Le guide du {uri-contribute}[parfait Contributeur] fournit des informations sur comment créer, styliser et soumettre des tickets, des demandes de fonctionnalités, du code et de la documentation pour le projet Asciidoctor.
+
+== Être aidé
+
+Le projet Asciidoctor est développé pour vous aider à écrire et publier du contenu.
+Mais nous ne pouvons pas le faire sans avoir vos avis !
+Nous vous encourageons à poser vos questions et discuter de n'importe quels aspects du projet sur la liste de discussion, Twitter ou dans le salon de discussion.
+
+Mailing list:: {uri-discuss}
+Twitter (Chat):: hashtag #asciidoctor ou la mention @asciidoctor
+Gitter (Chat):: image:https://badges.gitter.im/Join%20In.svg[Gitter, link=https://gitter.im/asciidoctor/asciidoctor]
+////
+IRC (Chat):: {uri-irc}[#asciidoctor] sur FreeNode IRC
+////
+
+ifdef::env-github[]
+De plus amples informations et documentations sur Asciidoctor peuvent être trouvées sur le site web du projet.
+
+{uri-project}/[Home] | {uri-news}[News] | {uri-docs}[Docs]
+endif::[]
+
+L'organisation Asciidoctor sur GitHub héberge le code source du projet, le gestionnaire de tickets ainsi que des sous-projets.
+
+Dépôt des sources (git):: {uri-repo}
+Gestionnaire de tickets:: {uri-issues}
+L'organisation Asciidoctor sur GitHub:: {uri-org}
+
+== Copyright et licence
+
+Copyright (C) 2012-2016 Dan Allen, Ryan Waldron et le projet Asciidoctor.
+Une utilisation libre de ce logiciel est autorisée sous les termes de la licence MIT.
+
+Consultez le fichier {uri-license}[LICENSE] pour plus de détails.
+
+== Auteurs
+
+*Asciidoctor* est mené par https://github.com/mojavelinux[Dan Allen] et https://github.com/graphitefriction[Sarah White] et reçoit de nombreuses contributions de la part de la {uri-contributors}[géniale communauté] Asciidoctor.
+Le projet a été initié en 2012 par https://github.com/erebor[Ryan Waldron] et est basé sur {uri-prototype}[un prototype] écrit par https://github.com/nickh[Nick Hengeveld].
+
+*AsciiDoc* a été démarré par Stuart Rackham et a reçu de nombreuses contributions de la part de la communauté AsciiDoc.
+
+== Changelog
+
+ifeval::[{safe-mode-level} < 20]
+include::CHANGELOG.adoc[tags=compact;parse,leveloffset=+1]
+endif::[]
+
+Référez-vous au fichier {uri-changelog}[CHANGELOG] pour une liste complète des changements des versions précédentes.