Try other extension for gitlab

README

-= Boilerplate template for Drupal projects 
+= Boilerplate template for Drupal projects
 SFL Drupal Team <drupal@lists.savoirfairelinux.net>
 v2.0, 2016-03-10
-:keywords: Drupal, SFL, SFLinux, AsciiDoc, Asciidoctor 
+:keywords: Drupal, SFL, SFLinux, AsciiDoc, Asciidoctor
 :page-layout: base
 :page-description: {description}
 :page-keywords: {keywords}
@@ -32,15 +32,15 @@ endif::[]
 
 
 image::http://test.savoirfairelinux.com/buildStatus/icon?job=drupal-sfl-boilerplate[Build status]
-   __________   _____  ____  ___  __  ____   
+   __________   _____  ____  ___  __  ____
   / __/ __/ /  /  _/ |/ / / / / |/_/ /_  /__ __
  _\ \/ _// /___/ //    / /_/ />  <    / / \ \ /
-/___/_/ /____/___/_/|_/\____/_/|_|   /_(_)_\_\ 
+/___/_/ /____/___/_/|_/\____/_/|_|   /_(_)_\_\
 
 
 // (to make a title: echo " CLIENT.PROJECT" | figlet -f smslant )
 
-This *generic template* aims at _implementating_ a default project tree, that then could be used as a *starter kit* for new Drupal projects. 
+This *generic template* aims at _implementating_ a default project tree, that then could be used as a *starter kit* for new Drupal projects.
 It uses our custom Drupal distribution {gitlab-sflinux}[*SFLinux*] as codebase.
 
 TIP: More information on our Drupal practices at Savoir-faire Linux are described in {sfl-wiki-drupal}[the official Wiki].
@@ -65,7 +65,7 @@ The following dependencies need to be installed:
 
 CAUTION: The installation procedure to set-up Docker is not described here. Please refer to the official documentation on how to install {doc-docker-installation}[Docker Engine]. The {doc-docker-baseimage}[Docker base image] should also be installed at this point.
 
-First, you should clone this repository. 
+First, you should clone this repository.
 
  $ git clone --recursive git@gitlab.savoirfairelinux.com:drupal/sfl-boilerplate.git
 
@@ -113,4 +113,3 @@ install it, then issue following command:
  $ asciidoctor-pdf README
 
 The README.pdf file shall be created in the current directory.
-

README.doc

+= Boilerplate template for Drupal projects
+SFL Drupal Team <drupal@lists.savoirfairelinux.net>
+v2.0, 2016-03-10
+:keywords: Drupal, SFL, SFLinux, AsciiDoc, Asciidoctor
+:page-layout: base
+:page-description: {description}
+:page-keywords: {keywords}
+ifdef::env-site[]
+:toc:
+:toc-placement: preamble
+endif::[]
+ifndef::env-site[]
+:toc: right
+:icons: font
+:idprefix:
+:idseparator: -
+:sectanchors:
+:source-highlighter: highlightjs
+endif::[]
+:experimental:
+:mdash: &#8212;
+:language: asciidoc
+:source-language: {language}
+// Refs
+:sfl-wiki-drupal: https://wiki.savoirfairelinux.com/wiki/Pratique_Drupal
+:doc-docker: https://www.docker.com/
+:doc-fabric: http://www.fabfile.org/
+:doc-docker-installation: https://docs.docker.com/engine/installation/
+:doc-docker-baseimage: https://gitlab.savoirfairelinux.com/drupal/docker-lampd/
+:doc-drush: http://docs.drush.org/en/master/
+:gitlab-sflinux: https://gitlab.savoirfairelinux.com/drupal/sflinux
+
+
+image::http://test.savoirfairelinux.com/buildStatus/icon?job=drupal-sfl-boilerplate[Build status]
+   __________   _____  ____  ___  __  ____
+  / __/ __/ /  /  _/ |/ / / / / |/_/ /_  /__ __
+ _\ \/ _// /___/ //    / /_/ />  <    / / \ \ /
+/___/_/ /____/___/_/|_/\____/_/|_|   /_(_)_\_\
+
+
+// (to make a title: echo " CLIENT.PROJECT" | figlet -f smslant )
+
+This *generic template* aims at _implementating_ a default project tree, that then could be used as a *starter kit* for new Drupal projects.
+It uses our custom Drupal distribution {gitlab-sflinux}[*SFLinux*] as codebase.
+
+TIP: More information on our Drupal practices at Savoir-faire Linux are described in {sfl-wiki-drupal}[the official Wiki].
+
+
+
+== System Requirements
+
+This installation profile has been designed to work with Drupal 7, and is compatible with PHP > 5.3.
+Ensure your system is properly installed.
+
+TIP: Whenever it is possible, you should use *Composer* to install and manage the PHP dependencies.
+
+The following dependencies need to be installed:
+
+* {doc-docker}[Docker]
+* {doc-docker-baseimage}[Docker base image]
+* {doc-fabric}[Fabric]
+* {doc-drush}[Drush] (version 6 or 7)
+
+== Installation
+
+CAUTION: The installation procedure to set-up Docker is not described here. Please refer to the official documentation on how to install {doc-docker-installation}[Docker Engine]. The {doc-docker-baseimage}[Docker base image] should also be installed at this point.
+
+First, you should clone this repository.
+
+ $ git clone --recursive git@gitlab.savoirfairelinux.com:drupal/sfl-boilerplate.git
+
+It is recommanded to clone with the _recursive_ option to automatically fetch the included _git submodules_ (namely, Drupalizer, our tasks-automation tool).
+
+TIP: If you properly init the submodule, you should have a _drupalizer_ directory at the repository root.
+
+Then, copy and, optionally, edit your local configuration file:
+
+ $ cp conf/local_vars.py drupalizer/local_vars.py
+
+You are now ready to build the SFLinux distribution:
+
+ $ cd drupalizer
+ $ fab local_setup
+
+The Docker image containing the Drupal installation should now be up and running, and the site should now be accessible at http://local.boilerplate.sfl.
+
+include::drupalizer/README[]
+
+== Official documentation
+
+More on Drupal distributions: https://www.drupal.org/documentation/build/distributions.
+
+More on Drush and Makefile: https://www.drupal.org/node/1432374.
+
+== About this document
+
+This document uses the Asciidoc syntax generator. It is a convenient
+tool allowing to write documentation in raw text files, and convert
+them to HTML or PDF later on.
+
+Visit https://github.com/asciidoctor[Asciidoctor @ *GitHub*] for more informations.
+
+To generate a HTML version, first install asciidoctor package on your
+Linux distribution, then issue following command:
+
+ $ asciidoctor README
+
+The README.html is generated in the current directory.
+
+Asciidoctor provides a native PDF renderer for Asciidoc. Still in alpha, but worth the try. Please follow the instructions on the official documentation to
+install it, then issue following command:
+
+ $ asciidoctor-pdf README
+
+The README.pdf file shall be created in the current directory.