From 3a1f935df4016c1ff07ac187419e68ab3fcf57c0 Mon Sep 17 00:00:00 2001
From: hitsuji_no_shippo <hitsujinoshippoequalsheeptail@gmail.com>
Date: Tue, 3 Mar 2020 11:14:15 +0900
Subject: [PATCH] docs(README): update How to use. (close #208)

---
 CHANGELOG.adoc |  8 ++---
 README.adoc    | 94 ++++++++++++++++++++++++++++++++++++++++++++------
 2 files changed, 88 insertions(+), 14 deletions(-)

diff --git a/CHANGELOG.adoc b/CHANGELOG.adoc
index 8140170..c9d415c 100644
--- a/CHANGELOG.adoc
+++ b/CHANGELOG.adoc
@@ -3,10 +3,9 @@
 :!author-email:
 :author: {author-name}
 :!email: {author-email}
-:revnumber: v1.102.0
-:revdate: 2020-03-03T10:12:26+0900
-:revremark: Add log that \
-            fix url of aricle-css-for-asciidoc repository linkin README.
+:revnumber: v1.103.0
+:revdate: 2020-03-03T11:12:25+0900
+:revremark: Add log that update how to use in README.
 :doctype: article
 :description: gatsby-simple-blog-with-asciidoctor Change Log
 :title:
@@ -55,6 +54,7 @@ ifndef::env-github[:icons: font]
 
 * Fix url of aricle-css-for-asciidoc repository link.
   (link:{issues-url}/189[#189^])
+* Update How to use. (close link:{issues-url}/208[#208^])
 
 
 == 0.4.0 (2020-03-01)
diff --git a/README.adoc b/README.adoc
index 7be3c3e..94c02ad 100644
--- a/README.adoc
+++ b/README.adoc
@@ -3,9 +3,9 @@
 :!author-email:
 :author: {author-name}
 :!email: {author-email}
-:revnumber: v1.55.1
-:revdate: 2020-03-03T10:20:42+0900
-:revremark: Fix url of hitsuji-no-shippo/article-css-for-asciidoc.
+:revnumber: v1.56.0
+:revdate: 2020-03-03T11:12:14+0900
+:revremark: Update How to use section.
 :doctype: article
 :description: {doctitle} README
 :title:
@@ -64,9 +64,9 @@ image:https://www.netlify.com/img/deploy/button.svg[
   link={netlify-app-url}/start/deploy?repository={repository-url},
   window=_blank]
 
-:sample-articles-repository-name: sample-posts-with-asciidoc
-:sample-articles-repository-link: link:{github-profile-url}/{sample-articles-repository-name}[ \
-  hitsuji-no-shippo/{sample-articles-repository-name}^]
+:sample-articles-repository-name: hitsuji-no-shippo/sample-posts-with-asciidoc
+:sample-articles-repository-link: link:{github-url}/{sample-articles-repository-name}[ \
+  {sample-articles-repository-name}^]
 [NOTE]
 ====
 :netlify-link: link:./netlify.toml[ \
@@ -468,9 +468,10 @@ The attributes of the page have priority.
 // collapsible block close
 ====
 
+:article-css-for-asciidoc-url: {github-profile-url}/article-css-for-asciidoc
 === Asciidoctor Support to CSS
 
-Use this link:{github-profile-url}/article-css-for-asciidoc/tree/e62009e621bfd7ebefbf59d4edced9d8307deeb6[
+Use this link:{article-css-for-asciidoc-url}/tree/e62009e621bfd7ebefbf59d4edced9d8307deeb6[
 git repository^].
 
 :repository-url-string-template: ${GIT_HOST}/${ARTICLES_REPOSITORY}
@@ -820,13 +821,86 @@ eslint supported.
 
 == How to use
 
+=== Use gatsby new
+
+. Install the Gatsby CLI.
++
+--
+[source, bash, subs="attributes"]
+----
+npm install -g gatsby-cli
+----
+--
+. Create a Gatsby site.
++
+--
+[source, bash, subs="attributes"]
+----
+gatsby new {doctitle} {repository-url}
+cd {doctitle}
+----
+--
+. Clone articles repository. +
+  Read xref:articles-management[] for details.
++
+--
+:declare-articles-repository-script: declare -x ARTICLES_REPOSITORY={sample-articles-repository-name}
+[source, bash, subs="attributes"]
+----
+{declare-articles-repository-script}
+npm run clone-articles
+----
+--
+. Clone CSS. +
+  Read xref:asciidoctor-support-to-css[] for details.
++
+--
 [source, bash, subs="attributes"]
 ----
-git clone {repository-url} my-blog-folder
-cd my-blog-folder
+git clone {article-css-for-asciidoc-url} src/components/Article/LightweightMarkup/scss
+----
+--
+. Start the site in `develop` mode.
++
+--
+[source, bash, subs="attributes"]
+----
+gatsby develop
+----
+--
+. Open the source code and start editing! +
+  Your site is now running at link:http://localhost:8000[^]. +
+  Open the `{doctitle}` directory in your code editor of choice and edit
+  `content/blog/hello-world/index.adoc`. Save your changes,
+  and the browser will update in real time!
++
+[NOTE]
+====
+You'll also see a second link: link:http://localhost:8000/___graphql[^].
+This is a tool you can use to experiment
+with querying your data. Learn more about using this tool in the link:https://www.gatsbyjs.org/tutorial/part-five/#introducing-graphiql[
+Gatsby tutorial^].
+====
+
+=== Use git clone
+
+[source, bash, subs="attributes"]
+----
+git clone {repository-url} {doctitle}
+cd {doctitle}
 yarn
-yarn dev
+{declare-articles-repository-script}
+yarn dev  // <1>
 ----
+<1> {blank}
++
+--
+.The following three commands are run.
+. `yarn run clone-articles`
+. `yarn run submodule` (Clone CSS)
+. `gatsby develop`
+--
+
 
 == How to deploy by Circle-CI in Medium.com