Skip to content

Demonstration of how to use AsciiDoc assembly with a solution pattern

Notifications You must be signed in to change notification settings

bfitzpat/assemblers-assemble

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

Demonstration of how to use AsciiDoc assembly with a solution pattern

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages