Skip to content

Gerry-Forde/2-camelk-basic-fcc-walkthrough

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Test to see if we can use AsciiDoc Assemblies

Uses an assembly for a solution pattern, breaking up the text into other adoc files for easier re-use and management.

This technique allows you author modules for Solution Patterns, then assemble the walkthrough.adoc files for Solution Explorer in a build step.

Prerequisites

  • Ruby installed locally (i.e. sudo apt-get install ruby-full)
  • Asciidoctor Ruby installed locally (i.e. sudo gem install asciidoctor)
  • Ruby Rake installed locally (i.e. sudo gem install rake)

Procedure

  1. Author your Solution Pattern using the following file naming convention:
  • walkthroughs/assembly-<walkthrough-name>.adoc - contains the first level heading and includes.
  • walkthroughs/<file-name>.adoc - contains the content for each module
  1. Run the following command in the root of your repo to render the appropriate walkthrough.adoc files:
rake

This command coalesces the assembly-<walkthrough-name>.adoc file with the includes and overwrites the <walkthrough-name>/walkthrough.adoc file.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages