Muwu User Guide

Appendix A – Command Line

muwu

Show the version number and a summary of commands.

muwu compile

Compile all parts of the project.

muwu compile css

Compile any CSS files.

muwu compile html

Compile any HTML files.

muwu compile html [index]

Compile only the HTML file with the given index number.

muwu compile js

Compile any JS files.

muwu concat

Concatenate all source files into a new, single markdown file. Includes section numbers and headings.

muwu help

Show the version number and a summary of commands.

muwu help [command]

Show more detailed help for the given command.

muwu inspect

Display the project options, the compiler manifest, index numbers of HTML files, and any exceptions.

muwu new

Create a new project as a subdirectory within the current working directory.

muwu reset css

Return the initial CSS files to their original contents.

muwu view

Open a compiled project in a web browser. (shortcut for open compiled/[index.html])

Appendix B – Default Project File Tree

{project directory}/
|-config/
| |-css/
|   |-base/
|   | |-html_elements.scss
|   | |-index.scss
|   | |-section_muwu.scss
|   | |-section_muwu_contents.scss
|   | |-section_muwu_metadata.scss
|   | |-section_muwu_navigator.scss
|   | |-section_muwu_subcontents.scss
|   | |-section_muwu_text.scss
|   | |-section_muwu_title.scss
|   | |-section_muwu_topic.scss
|   |-colors/
|   | |-dark.scss
|   | |-index.scss
|   | |-light.scss
|   |-extensions/
|   | |-index.scss
|   |-index.scss
|-text/
|-metadata.yml
|-options.yml
|-outline.yml

Appendix C – Default Project Options

generate_navigators_automatically: true
generate_subcontents_automatically: false
generate_topic_inner_identifiers: false
html_head_includes_metadata_tags: true
html_lang: nil
html_uses_javascript_navigation: false
markdown_allows_raw_html: false
outline_text_pathnames: 'flexible'
output_destination: 'file'
output_file_css_basename: nil
output_file_html_basename: 'index'
output_file_js_basename: nil
output_formats: ['html','css','js']
remote_publish: nil
remote_sync: nil
render_punctuation_smart: true
render_section_end_links: ['contents', 'top']
render_section_numbers: true
render_sections_distinctly_depth_max: nil
render_title_section_metadata: ['title', 'subtitle', 'author']
rsync_options: '--itemize-changes --recursive --verbose'
warning_if_parent_heading_lacks_source: true

Appendix D – Outline Directives

contents

Create a table of contents for the main text block.

- contents

contents [name]

Create a table of contents for the text block named [name].

- contents introduction

navigator

Create a navigator with links for home, next, and previous document.

Requires an outline with multiple documents.

- navigator

metadata

Show all metadata attributes

- metadata

metadata: [attributes]

Show the metadata attributes indicated by [attributes].

- metadata:
  - copyright
  - editor
  - publisher

subcontents

Create a table of contents only for the current document.

Requires an outline with multiple documents.

- subcontents

text:

Create a main text block.

- text:
  - Monday

text [name]:

Create a text block named [name]. A text block can contain multiple topics, and each topic can contain multiple subtopics.

- text introduction:
  - dedication

title

Create a title block.

- title

title: [attributes]

Create a title block that includes metadata values for [attributes].

- title:
  - title
  - subtitle
  - author

Appendix E – Outline for this Guide

This user guide was prepared and compiled with Muwu.

outline.yml

---
- Title:
  - title
- Metadata:
  - muwu version
  - date of this edition
- Contents
---
- Introduction:
  - About Muwu
  - Known Limitations
  - License and Disclaimer
---
- Before You Begin:
  - Requirements
  - Learn Markdown
  - Installing Muwu
---
- Getting Started:
  - Creating a Project
  - Editing Project Metadata:
    - Reserved Keywords
---
- Project Outline:
  - Simple Outline
  - Nested Outline
  - Directed Outline:
    - Contents:
      - Single Text Section
      - Multiple Text Sections
    - Document
    - Metadata:
      - Date of This Edition
    - Navigator
    - Subcontents
    - Text:
      - Single Text Section
      - Multiple Text Sections
    - Title
  - Headings and Filenames:
    - Implicit:
      - Implicit Filenames with Multiple Text Sections
    - Explicit
    - Flexible
  - Case Sensitivity
---
- Project Actions:
  - Inspect a Project
  - Compile a Project
  - Publish a Project
  - Sync a Project
  - Reset Project Components
  - Concatenate Source Files
---
- Project Options:
  - generate_navigators_automatically
  - generate_subcontents_automatically
  - generate_topic_inner_identifiers
  - html_includes_metadata_tags
  - html_lang
  - html_uses_javascript_navigation
  - markdown_allows_raw_html
  - markdown_renderer
  - outline_text_pathnames
  - output_destination
  - output_file_css_basename
  - output_file_html_basename
  - output_file_js_basename
  - output_formats
  - remote_publish
  - remote_sync
  - render_punctuation_smart
  - render_section_end_links
  - render_section_numbers
  - render_sections_distinctly_depth_max
  - render_title_section_metadata
  - rsync_options
  - warning_if_parent_heading_lacks_source
---
- Project Style Sheets:
  - Learn CSS
  - Inner Identifiers
---
- Troubleshooting a Project:
  - Projects that Compile:
    - If Content Is Missing
    - If Formatting Is Incorrect
  - Projects that Do Not Compile:
    - Muwu Exceptions:
      - is this a muwu project folder
      - stdout multiple documents
      - stdout multiple formats
    - YAML Exceptions
    - Sass Exceptions
---
- Contributing to Muwu
---
- Appendices:
  - command line
  - default project file tree
  - default project options
  - outline directives
  - outline for this guide