Hugo Book v1.0.0

First public release of the Hugo Book, available as: separate AsciiDoc
sources split by chapter; a single AsciiDoc document (pre-processed via
the AsciiDoc Coalescer); and converted to a standalone single HTML doc.

The Hugo Book is also served on the WWW via GitHub pages, as a single
HTML document.

.editorconfig

@@ -0,0 +1,125 @@
+##########################################
+#  The HUGO Book, by Kent Tessman 2004:  #
+#  https://github.com/tajmone/hugo-book  #
+##########################################
+
+root = true
+
+
+## AsciiDoc
+###########
+[*.{ad,adoc,asciidoc}]
+indent_size = unset
+indent_style = space
+end_of_line = unset
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = true
+
+
+## Batch Scripts
+################
+[*.bat]
+indent_style = tab
+indent_size = unset
+end_of_line = crlf
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = true
+
+
+## Configurations
+#################
+[.{git*,editorconfig,*.yml}]
+indent_style = space
+indent_size = unset
+end_of_line = lf
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = true
+
+
+## CSV
+#######
+[*.csv]
+indent_size = 2
+indent_style = space
+end_of_line = unset
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = false
+
+
+## Haml Templates
+#################
+[*.haml]
+indent_size = 2
+indent_style = space
+end_of_line = unset
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = true
+
+
+## Hugo Sources
+###############
+[.{hug,h,g}]
+indent_size = 8
+charset = latin1
+
+
+## Markdown GFM
+###############
+[*.md]
+indent_style = space
+indent_size = unset
+end_of_line = unset
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = true
+
+
+## Plain-Text Files
+###################
+[{*.txt,LICENSE}]
+indent_style = space
+indent_size = unset
+end_of_line = unset
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = unset
+
+
+## Ruby
+#######
+[*.rb]
+indent_size = 2
+indent_style = space
+end_of_line = lf
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = true
+
+
+## Sass/SCSS
+############
+[*.{sass,scss}]
+indent_size = 2
+indent_style = space
+end_of_line = unset
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = true
+
+
+## Shell Scripts
+################
+[*.sh]
+end_of_line = lf
+indent_style = tab
+indent_size = unset
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = true
+
+# EOF #

.gitattributes

@@ -5,48 +5,97 @@
 
 * text=auto
 
-## ===========================
-## Highlight langDefs & themes
-## ===========================
-*.lang    text
-*.theme   text
-## -------------------------
-## GitHub Linguist Settings:
-## -------------------------
-*.lang    linguist-language=Lua
-*.theme   linguist-language=Lua
-## -------------------------
-## GitLab Linguist Settings:
-## -------------------------
-*.lang    gitlab-language=Lua
-*.theme   gitlab-language=Lua
-
-## =============
-## Shell scripts
-## =============
-*.bat      text eol=crlf
-*.sh       text eol=lf
-
-## =================
-## WEB-RELATED FILES
-## =================
-*.html     text
-*.css      text
-
-## ===================
-## Documentation files
-## ===================
-*.adoc         text
-*.asciidoc     text
-*.md           text
-*.txt          text
-LICENSE        text
-
-## ===================
-## Configuration files
-## ===================
-.editorconfig  text
-.gitattributes text
-.gitignore     text
+
+## Repository Configuration
+###########################
+.editorconfig    text eol=lf
+.gitattributes   text eol=lf
+.gitconfig       text eol=lf
+.gitignore       text eol=lf
+.gitlab-ci.yml   text eol=lf
+.gitmodules      text eol=lf
+.travis.yml      text eol=lf
+
+
+## AsciiDoc Sources & Assets
+############################
+*.ad         text
+*.adoc       text
+*.asciidoc   text
+*.csv        text
+*.haml       text
+*.rb         text eol=lf
+
+
+## Highlight LangDefs & Themes
+##############################
+[attr]Hihglight text linguist-language=Lua gitlab-language=Lua
+*.lang    Hihglight
+*.theme   Hihglight
+
+
+## Hugo Source Files
+####################
+[attr]Hugo text linguist-language=Hugo gitlab-language=Hugo
+*.hug   Hugo
+*.h     Hugo
+*.g     Hugo
+
+
+## Shell Scripts
+################
+*.bat   text eol=crlf
+*.sh    text eol=lf
+*.ps1   text eol=crlf
+
+
+## Sass/SCSS
+############
+*.sass   text
+*.scss   text
+
+
+## Web-Related Files
+####################
+*.htm       text
+*.html      text
+*.css       text
+*.css.map   text
+*.js        text
+
+
+## Documentation Files
+######################
+*.docx    binary
+*.md      text
+*.odt     binary
+*.pdf     binary
+*.txt     text
+LICENSE   text
+
+
+## Image & Graphics Files
+#########################
+*.bmp    binary
+*.gif    binary
+*.ico    binary
+*.jpeg   binary
+*.jpg    binary
+*.png    binary
+*.psd    binary
+*.svg    binary
+*.svgz   binary
+*.tif    binary
+*.tiff   binary
+*.wbmp   binary
+*.webp   binary
+
+
+## Third Party Tools File Formats
+#################################
+# Dia Diagram Editor: http://dia-installer.de/
+*.dia    binary
+# ColorImpact 4 palettes: http://www.tigercolor.com
+*.cifc   binary
 
 # EOF #

.gitignore

@@ -3,14 +3,26 @@
 #  https://github.com/tajmone/hugo-book  #
 ##########################################
 
+# Local previews:
+/docs_src/hugo-book?_*.html
+/docs_src/preview.html
+
 ## TMP Work Files
 #################
+*.tmp
 ___*.*
+___*
 
 # Links and URLs:
 *.lnk
 *.url
 
+## Sass temp files
+##################
+*.css.map
+## Just in case someone still uses Ruby Sass:
+.sass-cache/
+
 ############################
 ## COMMON IGNORE PATTERNS ##
 ############################

.travis.yml

@@ -0,0 +1,46 @@
+##########################################
+#  The HUGO Book, by Kent Tessman 2004:  #
+#  https://github.com/tajmone/hugo-book  #
+##########################################
+
+dist: xenial
+
+git:
+  depth: false
+
+before_install:
+  - sudo apt-get update
+  - sudo apt-get install -y libboost-dev liblua5.3-dev
+install:
+  # ==================================
+  # Asciidoctor Toolchain Dependencies
+  # ==================================
+  - gem install asciidoctor tilt haml concurrent-ruby
+  # Clone and Compile Highlight from Sources:
+  - git clone https://gitlab.com/saalen/highlight highlight_src
+  - pushd ./highlight_src
+  - make cli
+  - sudo make install
+  - popd
+  # =====================================
+  # Install EditorConfig Validation Tools
+  # =====================================
+  - npm install -g eclint
+
+jobs:
+    include:
+    # ================================
+    # Asciidoctor Toolchain Build Test
+    # ================================
+    - name: "Asciidoctor Toolchain"
+      script:
+        - pushd ./docs_src/
+        - bash ./build.sh
+    # ==============================================
+    # EditorConfig Code Styles Validation via EClint
+    # ==============================================
+    # https://editorconfig.org
+    # https://www.npmjs.com/package/eclint
+    - name: "EditorConfig Validation"
+      script:
+        - bash ./validate.sh