Conversion du livre finie

La structure interne du livre reste valide.
Il peut manquer des modifications

Author: jnavila

A-git-in-other-environments.asc

@@ -11,9 +11,6 @@ include::book/A-git-in-other-environments/sections/guis.asc[]
 
 include::book/A-git-in-other-environments/sections/visualstudio.asc[]
 
-include::book/A-git-in-other-environments/sections/eclipse.asc[]
-
-
 include::book/A-git-in-other-environments/sections/bash.asc[]
 
 include::book/A-git-in-other-environments/sections/zsh.asc[]

B-embedding-git.asc renamed to B-embedding-git-in-your-applications.asc

@@ -1,16 +1,21 @@
 source 'https://rubygems.org'
 
 gem 'rake'
-gem 'asciidoctor', '1.5.6.2'
+gem 'asciidoctor', '2.0.12'
 
 gem 'json'
 gem 'awesome_print'
 
-gem 'asciidoctor-epub3', '~> 1.5.0.alpha.9'
-gem 'asciidoctor-pdf', '~> 1.5.0.beta.8'
+gem 'ttfunk', '1.5.1'
+gem 'asciidoctor-epub3', '1.5.0.alpha.19'
+gem 'asciidoctor-pdf', '1.5.0.alpha.16'
+gem 'asciidoctor-pdf-cjk', '~> 0.1.3'
+gem 'asciidoctor-pdf-cjk-kai_gen_gothic', '~> 0.1.1'
 
 gem 'coderay'
 gem 'pygments.rb'
 gem 'thread_safe'
-gem 'epubcheck'
-gem 'kindlegen'
+gem 'epubcheck-ruby'
+
+gem 'octokit'
+gem 'github_changelog_generator', github: 'Furtif/github-changelog-generator'

C-git-commands.asc

@@ -1,22 +1,244 @@
+# coding: utf-8
+require 'octokit'
+require 'github_changelog_generator'
+
+def exec_or_raise(command)
+  puts `#{command}`
+  if (! $?.success?)
+    raise "'#{command}' failed"
+  end
+end
+
+module GitHubChangelogGenerator
+
+  #OPTIONS = %w[ user project token date_format output
+  #              bug_prefix enhancement_prefix issue_prefix
+  #              header merge_prefix issues
+  #              add_issues_wo_labels add_pr_wo_labels
+  #              pulls filter_issues_by_milestone author
+  #              unreleased_only unreleased unreleased_label
+  #              compare_link include_labels exclude_labels
+  #              bug_labels enhancement_labels
+  #              between_tags exclude_tags exclude_tags_regex since_tag max_issues
+  #              github_site github_endpoint simple_list
+  #              future_release release_branch verbose release_url
+  #              base configure_sections add_sections]
+
+  def get_log(&task_block)
+    options = Parser.default_options
+    yield(options) if task_block
+
+    options[:user],options[:project] = ENV['TRAVIS_REPO_SLUG'].split('/')
+    options[:token] = ENV['GITHUB_API_TOKEN']
+    options[:unreleased] = false
+
+    generator = Generator.new options
+    generator.compound_changelog
+  end
+
+  module_function :get_log
+end
+
 namespace :book do
   desc 'build basic book formats'
   task :build do
+
+    puts "Generating contributors list"
+    exec_or_raise("git shortlog -s --all $translation_origin | grep -v -E '(Straub|Chacon)' | cut -f 2- | sort | column -c 110 > book/contributors.txt")
+
+    # detect if the deployment is using glob
+    travis = File.read(".travis.yml")
+    version_string = ENV['TRAVIS_TAG'] || '0'
+    if travis.match(/file_glob/)
+      progit_v = "progit_v#{version_string}"
+    else
+      progit_v = "progit"
+    end
+    text = File.read('progit.asc')
+    new_contents = text.gsub("$$VERSION$$", version_string).gsub("$$DATE$$", Time.now.strftime("%Y-%m-%d"))
+    File.open("#{progit_v}.asc", "w") {|file| file.puts new_contents }
+
     puts "Converting to HTML..."
-    `bundle exec asciidoctor progit.asc`
-    puts " -- HTML output at progit.html"
+    exec_or_raise("bundle exec asciidoctor -a data-uri #{progit_v}.asc")
+    puts " -- HTML output at #{progit_v}.html"
 
     puts "Converting to EPub..."
-    `bundle exec asciidoctor-epub3 progit.asc`
-    puts " -- Epub output at progit.epub"
+    exec_or_raise("bundle exec asciidoctor-epub3 #{progit_v}.asc")
+    puts " -- Epub output at #{progit_v}.epub"
 
-    puts "Converting to Mobi (kf8)..."
-    `bundle exec asciidoctor-epub3 -a ebook-format=kf8 progit.asc`
-    puts " -- Mobi output at progit.mobi"
+    exec_or_raise("epubcheck #{progit_v}.epub")
 
+    repo = ENV['TRAVIS_REPO_SLUG']
     puts "Converting to PDF... (this one takes a while)"
-    `bundle exec asciidoctor-pdf progit.asc 2> /dev/null`
-    puts " -- PDF output at progit.pdf"
+    if (repo == "progit/progit2-zh")
+      exec_or_raise("asciidoctor-pdf-cjk-kai_gen_gothic-install")
+      exec_or_raise("bundle exec asciidoctor-pdf -r asciidoctor-pdf-cjk -r asciidoctor-pdf-cjk-kai_gen_gothic -a pdf-style=KaiGenGothicCN #{progit_v}.asc")
+    elsif (repo == "progit/progit2-ja")
+      exec_or_raise("asciidoctor-pdf-cjk-kai_gen_gothic-install")
+      exec_or_raise("bundle exec asciidoctor-pdf -r asciidoctor-pdf-cjk -r asciidoctor-pdf-cjk-kai_gen_gothic -a pdf-style=KaiGenGothicJP #{progit_v}.asc")
+    elsif (repo == "progit/progit2-zh-tw")
+      exec_or_raise("asciidoctor-pdf-cjk-kai_gen_gothic-install")
+      exec_or_raise("bundle exec asciidoctor-pdf -r asciidoctor-pdf-cjk -r asciidoctor-pdf-cjk-kai_gen_gothic -a pdf-style=KaiGenGothicTW #{progit_v}.asc")
+    elsif (repo == "progit/progit2-ko")
+      exec_or_raise("asciidoctor-pdf-cjk-kai_gen_gothic-install")
+      exec_or_raise("bundle exec asciidoctor-pdf -r asciidoctor-pdf-cjk -r asciidoctor-pdf-cjk-kai_gen_gothic -a pdf-style=KaiGenGothicKR #{progit_v}.asc")
+    else
+      exec_or_raise("bundle exec asciidoctor-pdf #{progit_v}.asc 2>/dev/null")
+    end
+    puts " -- PDF output at #{progit_v}.pdf"
+  end
+
+  desc 'tag the repo with the latest version'
+  task :tag do
+    api_token = ENV['GITHUB_API_TOKEN']
+    if ((api_token) && (ENV['TRAVIS_PULL_REQUEST'] == 'false'))
+      repo = ENV['TRAVIS_REPO_SLUG']
+      @octokit = Octokit::Client.new(:access_token => api_token)
+      begin
+        last_version=@octokit.latest_release(repo).tag_name
+      rescue
+        last_version="2.1.-1"
+      end
+      new_patchlevel= last_version.split('.')[-1].to_i + 1
+      new_version="2.1.#{new_patchlevel}"
+      if  (ENV['TRAVIS_BRANCH']=='master')
+        obj = @octokit.create_tag(repo, new_version, "Version " + new_version,
+                                  ENV['TRAVIS_COMMIT'], 'commit',
+                                  'Automatic build', '[email protected]',
+                                  Time.now.utc.iso8601)
+        begin
+          @octokit.create_ref(repo, "tags/#{new_version}", obj.sha)
+        rescue
+          p "the ref already exists ???"
+        end
+        p "Created tag #{last_version}"
+      elsif (ENV['TRAVIS_TAG'])
+        version = ENV['TRAVIS_TAG']
+        changelog = GitHubChangelogGenerator.get_log do |config|
+          config[:since_tag] = last_version
+        end
+        credit_line = "\\* *This Change Log was automatically generated by [github_changelog_generator](https://github.com/skywinder/Github-Changelog-Generator)*"
+        changelog.gsub!(credit_line, "")
+        @octokit.create_release(repo, new_version, {:name => "v#{new_version}", :body => changelog})
+        p "Created release #{new_version}"
+      else
+        p 'This only runs on a commit to master'
+      end
+    else
+      p 'No interaction with GitHub'
+    end
+  end
+
+  desc 'convert book to asciidoctor compatibility'
+  task:convert do
+    `cp -aR ../progit2/images .`
+    `sed -i -e 's!/images/!!' .gitignore`
+    `git add images`
+    `git rm -r book/*/images`
+
+    chapters = [
+      ["01", "introduction"              ],
+      ["02", "git-basics"                ],
+      ["03", "git-branching"             ],
+      ["04", "git-server"                ],
+      ["05", "distributed-git"           ],
+      ["06", "github"                    ],
+      ["07", "git-tools"                 ],
+      ["08", "customizing-git"           ],
+      ["09", "git-and-other-scms"        ],
+      ["10", "git-internals"             ],
+      ["A",  "git-in-other-environments" ],
+      ["B",  "embedding-git"             ],
+      ["C",  "git-commands"              ]
+    ]
+
+    crossrefs = {}
+    chapters.each { | num, title |
+      if num =~ /[ABC]/
+        chap = "#{num}-#{title}"
+      else
+        chap = "ch#{num}-#{title}"
+      end
+      Dir[File.join ["book","#{num}-#{title}" , "sections","*.asc"]].map { |filename|
+        File.read(filename).scan(/\[\[(.*?)\]\]/)
+      }.flatten.each { |ref|
+        crossrefs[ref] = "#{chap}"
+      }
+    }
+
+    headrefs = {}
+    chapters.each { | num, title |
+      if num =~ /[ABC]/
+        chap = "#{num}-#{title}"
+      else
+        chap = "ch#{num}-#{title}"
+      end
+      Dir[File.join ["book","#{num}-#{title}", "*.asc"]].map { |filename|
+        File.read(filename).scan(/\[\[([_a-z0-9]*?)\]\]/)
+      }.flatten.each { |ref|
+        headrefs[ref] = "#{chap}"
+      }
+    }
+
+    # transform all internal cross refs
+    chapters.each { | num, title |
+      if num =~ /[ABC]/
+        chap = "#{num}-#{title}"
+      else
+        chap = "ch#{num}-#{title}"
+      end
+      files = Dir[File.join ["book","#{num}-#{title}" , "sections","*.asc"]] +
+              Dir[File.join ["book","#{num}-#{title}" ,"1-*.asc"]]
+      p files
+      files.each { |filename|
+        content = File.read(filename)
+        new_contents = content.gsub(/\[\[([_a-z0-9]*?)\]\]/, '[[r\1]]').gsub(
+          "&rarr;", "→").gsub(/<<([_a-z0-9]*?)>>/) { |match|
+          ch = crossrefs[$1]
+          h = headrefs[$1]
+          # p " #{match} -> #{ch}, #{h}"
+          if ch
+            # if local do not add the file
+            if ch==chap
+              "<<r#{$1}>>"
+            else
+              "<<#{ch}#r#{$1}>>"
+            end
+          elsif h
+            if h==chap
+              "<<#{chap}>>"
+            else
+              "<<#{h}##{h}>>"
+            end
+          else
+            p "could not match xref #{$1}"
+            "<<#{$1}>>"
+          end
+        }
+        File.open(filename, "w") {|file| file.puts new_contents }
+      }
+    }
+
+    chapters.each { | num, title |
+      if num =~ /[ABC]/
+        chap = "#{num}-#{title}"
+      else
+        chap = "ch#{num}-#{title}"
+      end
+      Dir[File.join ["book","#{num}-#{title}" ,"1*.asc"]].map { |filename|
+        content = File.read (filename)
+        new_contents = content.gsub(/include::(.*?)asc/) {|match|
+          "include::book/#{num}-#{title}/#{$1}asc"}
+        `git rm -f #{filename}`
+        File.open("#{chap}.asc", "w") {|file|
+          file.puts "[##{chap}]\n"
+          file.puts new_contents }
+        `git add "#{chap}.asc"`
+      }
+    }
   end
 end
 
+
+
 task :default => "book:build"

Gemfile

@@ -45,6 +45,7 @@ Si vous souhaitez surcharger ces valeurs avec un nom ou une adresse de courriel
 
 De nombreux outils graphiques vous aideront à le faire la première fois que vous les lancerez.
 
+[[ch_editor]]
 ==== Votre éditeur de texte
 
 À présent que votre identité est renseignée, vous pouvez configurer l'éditeur de texte qui sera utilisé quand Git vous demande de saisir un message.

Rakefile

@@ -225,7 +225,7 @@ Les règles de construction des patrons à placer dans le fichier `.gitignore` s
 * un patron commençant par un point d'exclamation (`!`) indique des fichiers à inclure malgré les autres règles.
 
 Les patrons standards de fichiers sont des expressions régulières simplifiées utilisées par les shells.
-Un astérisque (`*`) correspond à un ou plusieurs caractères ; `[abc]` correspond à un des trois caractères listés dans les crochets, donc a ou b ou c ; un point d'interrogation (`?`) correspond à un unique caractère ; des crochets entourant des caractères séparés par un tiret (`[0-9]`) correspond à un caractère dans l'intervalle des deux caractères indiqués, donc ici de 0 à 9.
+Un astérisque (`\*`) correspond à un ou plusieurs caractères ; `[abc]` correspond à un des trois caractères listés dans les crochets, donc a ou b ou c ; un point d'interrogation (`?`) correspond à un unique caractère ; des crochets entourant des caractères séparés par un tiret (`[0-9]`) correspond à un caractère dans l'intervalle des deux caractères indiqués, donc ici de 0 à 9.
 Vous pouvez aussi utiliser deux astérisques pour indiquer une série de répertoires inclus ; `a/**/z` correspond donc à `a/z`, `a/b/z`, `a/b/c/z` et ainsi de suite.
 
 Voici un autre exemple de fichier `.gitignore` :
@@ -559,8 +559,8 @@ Cela signifie que vous pouvez lancer des commandes telles que :
 $ git rm log/\*.log
 ----
 
-Notez bien la barre oblique inverse (`\`) devant `*`.
-Il est nécessaire d'échapper le caractère `*` car Git utilise sa propre expansion de nom de fichier en addition de l'expansion du shell.
+Notez bien la barre oblique inverse (`\`) devant `\*`.
+Il est nécessaire d'échapper le caractère `\*` car Git utilise sa propre expansion de nom de fichier en addition de l'expansion du shell.
 Ce caractère d'échappement doit être omis sous Windows si vous utilisez le terminal système.
 Cette commande efface tous les fichiers avec l'extension `.log` présents dans le répertoire `log/`.
 Vous pouvez aussi lancer une commande telle que :

book/01-introduction/sections/first-time-setup.asc

@@ -43,7 +43,7 @@ L'intérêt immédiat de la rectification de commit est de faire des petites am
 ====
 Ne rectifiez que les commits qui ne sont que locaux et n'ont pas été poussés.
 La rectification de commit qui ont été poussés et la poussée en force de branche risque de créer des problèmes avec vos collaborateurs.
-Pour plus d'information sur ce qui arrive si vous le faites et comment s'en sortir en fin de compte, lisez <<s_rebase_perils>>
+Pour plus d'information sur ce qui arrive si vous le faites et comment s'en sortir en fin de compte, lisez <<s_rebase_peril>>
 ====
 
 [[s_unstaging]]

book/02-git-basics/sections/recording-changes.asc

@@ -122,7 +122,7 @@ To https://github.com/tonychacon/blink
 
 Maintenant, si nous allons sur notre projet dupliqué sur GitHub, nous pouvons voir que GitHub a remarqué que nous avons poussé une nouvelle branche thématique et affiche un gros bouton vert pour vérifier nos modifications et ouvrir une requête de tirage sur le projet original.
 
-Vous pouvez aussi vous rendre à la page « Branches » à `https://github.com/<utilisateur>/<projet>/branches` pour trouver votre branche et ouvrir une requête de tirage à partir de là.
+Vous pouvez aussi vous rendre à la page « Branches » à `\https://github.com/<utilisateur>/<projet>/branches` pour trouver votre branche et ouvrir une requête de tirage à partir de là.
 
 .Le bouton Pull Request
 image::images/blink-02-pr.png[Le bouton Pull Request]
@@ -303,7 +303,7 @@ En fait, il y a de très très nombreuses manières de faire référence à d'au
 Commençons par la manière de faire référence à une autre requête de tirage ou à une anomalie (Issue).
 Toutes les requêtes de tirage et toutes les anomalies sont identifiées par des numéros qui sont uniques au sein d'un projet.
 Par exemple, vous ne pouvez avoir une requête de tirage numéro 3 et une anomalie numéro 3.
-Si vous voulez faire référence à n'importe quelle requête de tirage ou anomalie depuis l'une ou l'autre du même projet, il vous suffit d'insérer `#<numéro>` dans n'importe quel commentaire ou n'importe quelle description.
+Si vous voulez faire référence à n'importe quelle requête de tirage ou anomalie depuis l'une ou l'autre du même projet, il vous suffit d'insérer `\#<numéro>` dans n'importe quel commentaire ou n'importe quelle description.
 Vous pouvez aussi référencer une requête ou une anomalie d'un autre dépôt dupliqué du dépôt actuel en utilisant la syntaxe `<utilisateur>#<numéro>`, ou même un autre dépôt indépendant avec la syntaxe `<utilisateur>/<dépôt>#<numéro>`.
 
 Voyons cela sur un exemple.

book/02-git-basics/sections/undoing.asc

@@ -27,7 +27,7 @@ Puisque vous n'avez pas encore de code, GitHub vous affiche des instructions sur
 Nous ne détaillerons pas cela ici ; si vous avez besoin d'un rappel, vérifiez <<ch02-git-basics#ch02-git-basics>>.
 
 Maintenant que votre projet est hébergé sur GitHub, vous pouvez donner l'URL à toutes les personnes avec lesquelles vous voulez partager votre projet.
-Chaque projet est accessible via HTTP par `https://github.com/<utilisateur>/<nom_du_projet>` et via SSH par `[email protected]:<utilisateur>/<nom_du_projet>`.
+Chaque projet est accessible via HTTP par `\https://github.com/<utilisateur>/<nom_du_projet>` et via SSH par `[email protected]:<utilisateur>/<nom_du_projet>`.
 Git peut récupérer et pousser en utilisant les deux URL mais l'accès est contrôlé sur la base des paramètres d'authentification de l'utilisateur qui s'y connecte.
 
 [NOTE]