_book.yml

# Chapter manifest for the twinBASIC documentation PDF.
#
# ── Selector schema ───────────────────────────────────────────────────
# Shared by front_matter entries, parts, and chapter entries:
#
#   page          single URL prefix; shorthand for a one-element
#                 `pages:` list. Default match is `contains` (the
#                 page's URL contains this string). Combinable with
#                 `pages:`, `nav_page:`, `nav_pages:`.
#   pages         list of URL prefixes. Each entry is a `contains`
#                 match unless `no_descent:` is set on this entry.
#   nav_page      single nav-path prefix; shorthand for a one-element
#                 `nav_pages:` list. The page's `nav_path` is the
#                 slash-joined `grand_parent / parent / title` chain
#                 populated by `_plugins/nav-path.rb`.
#   nav_pages     list of nav-path prefixes.
#   no_descent    optional truthy. Switches every `page` / `pages` /
#                 `nav_page` / `nav_pages` match on this entry from
#                 the default `contains` semantics to exact equality
#                 (`==`). Use it when a prefix like `/Foo/` should
#                 match only the index, not its sub-pages; or when
#                 a one-page entry like `page: /` would otherwise
#                 sweep in every page on the site.
#
# ── Common entry options ──────────────────────────────────────────────
# Parts and chapter entries share all of the following options.
# Where behaviour differs by level, the part form is noted first with
# the chapter form in parentheses. "Divider heading" = H1 for parts,
# H2 for chapters.
#
#   title / subtitle
#                 -- divider page text.
#   landing_page  -- single absolute URL emitted first in the entry's
#                    content list, before any prefix-swept pages.
#                    Filtered out from prefix matches so it is not
#                    double-emitted. Unlike `foreword_page:`, it renders
#                    as a regular article (running header, normal
#                    styling). Its source H1 is stripped by the rewriter
#                    so the divider heading remains the sole outline
#                    entry. The strip is skipped when `no_outline_entry:`
#                    is also set -- in that case the landing's first
#                    heading IS the bookmark target.
#   landing_is_target
#                 -- optional truthy. Requires `landing_page:`. When
#                    set, the divider renders silently and the entry
#                    title is injected as the divider heading (H1 / H2)
#                    at the start of the landing-page article, so the
#                    PDF bookmark carries the entry title but navigates
#                    directly to the landing page rather than the blank
#                    divider page. The landing's own source H1 is still
#                    stripped. Pair with `outline_closed:` to start the
#                    bookmark collapsed. Contrast with `no_outline_entry`
#                    + `no_heading_shift`, which promotes the landing's
#                    own H1 text (not the entry title) as the outline
#                    entry.
#   no_outline_entry
#                 -- optional truthy. When set, the divider emits its
#                    title as a silent `<p>` instead of the divider
#                    heading (H1 / H2), so PagedJS skips it for the PDF
#                    outline. The divider page still renders visually.
#                    When also used with `landing_page:`, the landing's
#                    source H1 strip is skipped so the landing's first
#                    heading becomes the bookmark target. Pair with
#                    `no_heading_shift:` to keep that heading at the
#                    right depth.
#   no_heading_shift
#                 -- optional truthy.
#                    For parts: every page in the part skips the base
#                    +1 heading shift, so source H1 renders as H1 (not
#                    H2). Use with `no_outline_entry:` when a flat
#                    part's only page would otherwise have its H1
#                    shifted to H2 and buried under the silent divider.
#                    For chapters: this chapter's body skips the
#                    chaptered-part extra +1 shift (chapters normally
#                    receive +2 total: base + extra), so its source H1
#                    lands one level shallower. Pair with
#                    `no_outline_entry:` to promote that heading into
#                    the outline slot vacated by the silent divider.
#   outline_closed
#                 -- optional truthy. Starts the PDF bookmark for this
#                    entry collapsed (children hidden until expanded).
#                    For entries with a real divider heading (H1 / H2):
#                    `data-pdf-bookmark-closed` is stamped on that
#                    heading. For `no_outline_entry` entries (whose
#                    bookmark is the first content heading): stamped on
#                    the first content article; parseOutline finds the
#                    heading via closest(). For `landing_is_target`
#                    entries: stamped on the injected heading directly.
#                    Ignored when the entry has no bookmark at all.
#
# ── front_matter ──────────────────────────────────────────────────────
# An ordered list of sections emitted between the title page and the
# first numbered Part. No divider page, no part number; each entry
# contributes its pages inline. Each entry may set `title:` (used as
# the anchor seed when the URL collapses to an empty path -- e.g. `/`
# becomes `ch-introduction`) plus any selector-schema keys above.
#
# ── parts ─────────────────────────────────────────────────────────────
# An ordered list of numbered book parts. Each part uses the selector
# schema and common entry options above, plus:
#
#   foreword_page -- single absolute URL emitted as
#                    `<article class="part-foreword">` right after the
#                    part divider, before any chapter dividers. No
#                    running header (CSS suppresses chrome via a named
#                    page). Distinct from `landing_page:` -- no source-
#                    H1 strip, no outline entry of its own.
#   chapters      -- ordered list of chapter entries. Each chapter has
#                    its own divider page; the part becomes a container
#                    for several distinct subjects rather than a flat
#                    folder. Each chapter entry uses the selector schema
#                    and common entry options above. No chapter-specific
#                    options exist beyond those shared with parts.
#
# ── left_out ──────────────────────────────────────────────────────────
# The pages deliberately not in the book. Each entry uses the selector
# schema above plus a `reason:`. Every page must be selected by a book
# entry or by a left_out entry: the build warns about a page that is in
# neither, about a page that is in both, and about an entry here that
# matches no page. So a new page cannot drop out of the book unnoticed,
# and a renamed one cannot leave a stale entry behind.
#
# ── Sort order ────────────────────────────────────────────────────────
# Per-entry content lists are ordered by sort_by_nav_order: folder-
# style index pages first (URL ends in `/`), then nav_order pages by
# nav_order ascending with title tie-break, then nav_order-less pages
# alphabetically by title. Groups by owning index URL so an index and
# its sub-pages stay adjacent.

front_matter:
  - title: Introduction
    page: /
    no_outline_entry: true
    no_heading_shift: true
    no_descent: true
    outline_closed: true

parts:
  - title: Features
    subtitle: Language additions, tooling, and packaging
    # DONE
    landing_page: /Features/
    outline_closed: true
    chapters:
      - title: Attributes
        page: /Features/Attributes-Intro
        no_outline_entry: true
        no_heading_shift: true
        outline_closed: true
      - title: Language Syntax
        page: /Features/Language/
        no_outline_entry: true
        no_heading_shift: true
        outline_closed: true
      - title: Project Configuration
        page: /Features/Project-Configuration/
        no_outline_entry: true
        no_heading_shift: true
        outline_closed: true
      - title: Standard Library
        page: /Features/Standard-Library/
        no_outline_entry: true
        no_heading_shift: true
        outline_closed: true
      - title: GUI Components
        page: /Features/GUI-Components/
        no_outline_entry: true
        no_heading_shift: true
        outline_closed: true
      - title: Package Management
        page: /Features/Packages/
        no_outline_entry: true
        no_heading_shift: true
        outline_closed: true
      - title: Advanced Features
        page: /Features/Advanced/
        no_outline_entry: true
        no_heading_shift: true
        outline_closed: true
      - title: Compiler and IDE
        page: /Features/Compiler-IDE/
        no_outline_entry: true
        no_heading_shift: true
        outline_closed: true
      - title: 64-bit Compilation
        page: /Features/64bit
        no_outline_entry: true
        no_heading_shift: true
        outline_closed: true
      - title: Fusion
        page: /Features/Fusion
        outline_closed: true

  - title: LLVM
    subtitle: Faster and smaller programs with the LLVM compiler back end
    landing_page: /LLVM/
    page: /LLVM/
    outline_closed: true

  - title: Frequently Asked Questions
    subtitle: Status, scope, and how to get help
    page: /FAQ
    outline_closed: true
    #landing_is_target: true
    no_outline_entry: true
    no_heading_shift: true

  - title: Tutorials
    subtitle: The foundations, then worked code examples for Arrays, CEF, WebView2, and CustomControls
    landing_page: /Tutorials/
    outline_closed: true
    # DONE
    chapters:
      - title: Hello World
        page: /Tutorials/Hello-World
        no_outline_entry: true
        no_heading_shift: true
        outline_closed: true
      - title: Forms Basics
        page: /Tutorials/Forms
        no_outline_entry: true
        no_heading_shift: true
        outline_closed: true
      - title: Calling the Windows API
        page: /Tutorials/Windows-API
        no_outline_entry: true
        no_heading_shift: true
        outline_closed: true
      - title: Writing Unit Tests with Assert
        page: /Tutorials/Testing-with-Assert
        no_outline_entry: true
        no_heading_shift: true
        outline_closed: true
      - title: Arrays
        page: /Tutorials/Arrays
        no_outline_entry: true
        no_heading_shift: true
        outline_closed: true
      - title: CEF
        subtitle: Chromium Embedded Framework
        page: /Tutorials/CEF/
        no_outline_entry: true
        no_heading_shift: true
        outline_closed: true
      - title: Custom Controls
        page: /Tutorials/CustomControls/
        no_outline_entry: true
        no_heading_shift: true
        outline_closed: true
      - title: WebView2
        page: /Tutorials/WebView2/
        no_outline_entry: true
        no_heading_shift: true
        outline_closed: true

  - title: The twinBASIC IDE
    subtitle: Starting, configuring, building, and debugging a project
    # Only the IDE pages with prose of their own. The rest of the section
    # is in left_out at the end of this file; move a page from there to
    # here once it explains something. Links to the pages left out open
    # the website.
    landing_page: /tB/IDE
    outline_closed: true
    chapters:
      - title: New Project
        page: /tB/IDE/Project/New
        no_outline_entry: true
        no_heading_shift: true
        outline_closed: true
      - title: Projects and files
        landing_page: /tB/IDE/Projects/
        page: /tB/IDE/Projects/
        landing_is_target: true
        outline_closed: true
      - title: Project Settings
        page: /tB/IDE/Project-Settings
        no_outline_entry: true
        no_heading_shift: true
        outline_closed: true
      - title: Writing code
        landing_page: /tB/IDE/Code/
        page: /tB/IDE/Code/
        landing_is_target: true
        outline_closed: true
      - title: Designing forms
        landing_page: /tB/IDE/Forms/
        page: /tB/IDE/Forms/
        landing_is_target: true
        outline_closed: true
      - title: Designing reports
        page: /tB/IDE/Reports/
        no_outline_entry: true
        no_heading_shift: true
        outline_closed: true
      - title: Running and debugging
        landing_page: /tB/IDE/Debugging/
        page: /tB/IDE/Debugging/
        landing_is_target: true
        outline_closed: true
      - title: Customising the IDE
        landing_page: /tB/IDE/Customising/
        page: /tB/IDE/Customising/
        landing_is_target: true
        outline_closed: true
      - title: Add Ins
        page: /tB/IDE/AddIns/
        no_descent: true
        no_outline_entry: true
        no_heading_shift: true
        outline_closed: true
      - title: Help Add-In
        page: /tB/IDE/AddIns/Help
        no_outline_entry: true
        no_heading_shift: true
        outline_closed: true
      - title: IDE Reference
        pages:
          - /tB/IDE/Reference/Toolbar
        outline_closed: true

  - title: The Core Language
    subtitle: Statements, operators, and built-in keywords
    outline_closed: true
    chapters:
      - title: Categorical List
        page: /Reference/Categories
        no_outline_entry: true
        no_heading_shift: true
        outline_closed: true
      - title: Statements
        nav_page: Reference Section/Statements
        nav_pages:
          - Statements
        no_outline_entry: true
        no_heading_shift: true
        outline_closed: true
      - title: Procedures and Functions
        page: /Reference/Procedures-and-Functions
        no_outline_entry: true
        no_heading_shift: true
        outline_closed: true
      - title: Operators
        nav_page: Reference Section/Operators
        outline_closed: true
      - title: Data Types
        page: /Reference/Data-Types
        no_outline_entry: true
        no_heading_shift: true
        outline_closed: true
      - title: Compiler Constants
        page: /Reference/Compiler-Constants
        no_outline_entry: true
        no_heading_shift: true
        outline_closed: true
      - title: Attributes
        page: /tB/Core/Attributes
        no_outline_entry: true
        no_heading_shift: true
        outline_closed: true
        

  - title: Reference Section
    subtitle: Controls, enumerations, COM interfaces, twinBASIC's additions, and the glossary
    outline_closed: true
    chapters:
      - title: Controls
        landing_page: /tB/Controls
        outline_closed: true
      - title: Enumerations
        landing_page: /Reference/Enumerations
        outline_closed: true
      - title: COM Interfaces
        landing_page: /Reference/COM-Interfaces/
        page: /Reference/COM-Interfaces/
        outline_closed: true
      - title: twinBASIC Additions
        landing_page: /Reference/twinBASIC-Additions
        outline_closed: true
      - title: Glossary
        landing_page: /tB/Gloss
        outline_closed: true

  - title: Packages
    subtitle: The runtime and library packages shipped with twinBASIC, and those the community publishes
    outline_closed: true
    # The /tB/Packages/ landing page is the part's foreword; its content
    # (an overview of all built-in packages) sits between the part divider
    # and the first chapter divider, with no running header. Each package
    # below becomes a chapter with a dedicated chapter-divider title
    # page; the chapter's own source landing page emits next (with its
    # source H1 stripped by the plugin to avoid the redundancy with the
    # chapter divider's H2), followed by the package's class / module /
    # control pages in URL order.
    foreword_page: /tB/Packages/
    chapters:
      - title: Default Packages
        subtitle: VB, VBA, and VBRUN --- included in every project by default
        landing_page: /tB/Packages/Default/
        landing_is_target: true
        outline_closed: true

      - title: VBA Package
        subtitle: Standard runtime modules --- Strings, Math, FileSystem, and the rest
        landing_page: /tB/Packages/VBA
        page: /tB/Modules/
        landing_is_target: true
        outline_closed: true

      - title: VBRUN Package
        subtitle: Runtime types for controls, errors, and the property bag
        landing_page: /tB/Packages/VBRUN/
        page: /tB/Packages/VBRUN/
        landing_is_target: true
        outline_closed: true        

      - title: VB Package
        subtitle: Classic VB6 forms and intrinsic controls
        landing_page: /tB/Packages/VB/
        page: /tB/Packages/VB/
        landing_is_target: true
        outline_closed: true

      - title: Built-In Packages
        subtitle: Nine optional packages shipped with twinBASIC, always available offline
        landing_page: /tB/Packages/Built-In/
        landing_is_target: true
        outline_closed: true

      - title: WebView2 Package
        subtitle: Chromium-based browser control via Microsoft Edge WebView2
        landing_page: /tB/Packages/WebView2/
        page: /tB/Packages/WebView2/
        landing_is_target: true
        outline_closed: true

      - title: Assert Package
        subtitle: Test assertions with Exact, Strict, and Permissive comparison
        landing_page: /tB/Packages/Assert/
        page: /tB/Packages/Assert/
        landing_is_target: true
        outline_closed: true

      - title: CustomControls Package
        subtitle: The WaynesControls suite and its supporting framework
        landing_page: /tB/Packages/CustomControls/
        page: /tB/Packages/CustomControls/
        landing_is_target: true
        outline_closed: true

      - title: CEF Package
        subtitle: Chromium Embedded Framework browser control
        landing_page: /tB/Packages/CEF/
        page: /tB/Packages/CEF/
        landing_is_target: true
        outline_closed: true

      - title: WinEventLogLib Package
        subtitle: Windows Event Log integration
        landing_page: /tB/Packages/WinEventLogLib/
        page: /tB/Packages/WinEventLogLib/
        landing_is_target: true
        outline_closed: true

      - title: WinNamedPipesLib Package
        subtitle: Asynchronous named-pipe framework over IOCP
        landing_page: /tB/Packages/WinNamedPipesLib/
        page: /tB/Packages/WinNamedPipesLib/
        landing_is_target: true
        outline_closed: true

      - title: WinServicesLib Package
        subtitle: Windows Services hosting
        landing_page: /tB/Packages/WinServicesLib/
        page: /tB/Packages/WinServicesLib/
        landing_is_target: true
        outline_closed: true

      - title: tbIDE Package
        subtitle: IDE Extensibility --- the addin SDK
        landing_page: /tB/Packages/tbIDE/
        page: /tB/Packages/tbIDE/
        landing_is_target: true
        outline_closed: true

      - title: WinNativeCommonCtls Package
        subtitle: VB6-compatible Common Controls replacement on top of Win32 ComCtl32
        landing_page: /tB/Packages/WinNativeCommonCtls/
        page: /tB/Packages/WinNativeCommonCtls/
        landing_is_target: true
        outline_closed: true

      - title: AppGlobalClassObject Package
        subtitle: The App global object available in every project
        landing_page: /tB/Packages/AppGlobalClassObject/
        page: /tB/Packages/AppGlobalClassObject/
        landing_is_target: true
        outline_closed: true

      - title: Contributed Packages
        subtitle: Community packages published through TWINSERV, each versioned apart from twinBASIC
        landing_page: /tB/Packages/Contributed/
        landing_is_target: true
        outline_closed: true

      - title: AutoCompleteLib Package
        subtitle: Windows shell auto-complete for text-input controls
        landing_page: /tB/Packages/Contributed/AutoCompleteLib/
        page: /tB/Packages/Contributed/AutoCompleteLib/
        landing_is_target: true
        outline_closed: true

      - title: FileProps Package
        subtitle: The Windows shell properties of a file
        landing_page: /tB/Packages/Contributed/FileProps/
        page: /tB/Packages/Contributed/FileProps/
        landing_is_target: true
        outline_closed: true

      - title: Fmt Package
        subtitle: A string built from a format string and values, in the style of C#'s String.Format
        landing_page: /tB/Packages/Contributed/Fmt/
        page: /tB/Packages/Contributed/Fmt/
        landing_is_target: true
        outline_closed: true

      - title: Generics Package
        subtitle: Tuples, read-only objects that hold one to seven values of declared types
        landing_page: /tB/Packages/Contributed/Generics/
        page: /tB/Packages/Contributed/Generics/
        landing_is_target: true
        outline_closed: true

      - title: OLEGuids Package
        subtitle: OLE and COM interfaces and structures in twinBASIC source, in place of OLEGuids.tlb
        landing_page: /tB/Packages/Contributed/OLEGuids/
        page: /tB/Packages/Contributed/OLEGuids/
        landing_is_target: true
        outline_closed: true

      - title: tbFileSysTools Package
        subtitle: Files, folders, drives and text streams, in place of the Scripting Runtime's FileSystemObject
        landing_page: /tB/Packages/Contributed/tbFileSysTools/
        page: /tB/Packages/Contributed/tbFileSysTools/
        landing_is_target: true
        outline_closed: true

      - title: TBMANLIB_ListBoxHScroll Package
        subtitle: A horizontal scroll bar for a ListBox
        landing_page: /tB/Packages/Contributed/TBMANLIB_ListBoxHScroll/
        page: /tB/Packages/Contributed/TBMANLIB_ListBoxHScroll/
        landing_is_target: true
        outline_closed: true

      - title: TBMANLIB_RES Package
        subtitle: Resources embedded in an executable, as bytes, strings, hex, Base64 or pictures
        landing_page: /tB/Packages/Contributed/TBMANLIB_RES/
        page: /tB/Packages/Contributed/TBMANLIB_RES/
        landing_is_target: true
        outline_closed: true

      - title: tbProjPacker Package
        subtitle: Project files unpacked into source folders, and packed again
        landing_page: /tB/Packages/Contributed/tbProjPacker/
        page: /tB/Packages/Contributed/tbProjPacker/
        landing_is_target: true
        outline_closed: true

      - title: tbRegExp Package
        subtitle: Regular expressions, in place of VBScript's RegExp object
        landing_page: /tB/Packages/Contributed/tbRegExp/
        page: /tB/Packages/Contributed/tbRegExp/
        landing_is_target: true
        outline_closed: true

      - title: tsJson Package
        subtitle: A JSON model with parsing, JSONPath queries, JSON Pointer, JSON Patch and JSON Schema validation
        landing_page: /tB/Packages/Contributed/tsJson/
        page: /tB/Packages/Contributed/tsJson/
        landing_is_target: true
        outline_closed: true

      - title: tsPwGen Package
        subtitle: Passwords, PINs and passphrases, with their entropy known before they are generated
        landing_page: /tB/Packages/Contributed/tsPwGen/
        page: /tB/Packages/Contributed/tsPwGen/
        landing_is_target: true
        outline_closed: true

      - title: TwinTimerLib Package
        subtitle: A Win32 timer class that reports the elapsed time
        landing_page: /tB/Packages/Contributed/TwinTimerLib/
        page: /tB/Packages/Contributed/TwinTimerLib/
        landing_is_target: true
        outline_closed: true

      - title: VBA_JSON Package
        subtitle: JSON parsing and serialization, with UTC and ISO 8601 date conversion
        landing_page: /tB/Packages/Contributed/VBA_JSON/
        page: /tB/Packages/Contributed/VBA_JSON/
        landing_is_target: true
        outline_closed: true

      - title: VBComDlg Package
        subtitle: The CommonDialog class, for the Windows common dialogs
        landing_page: /tB/Packages/Contributed/VBComDlg/
        page: /tB/Packages/Contributed/VBComDlg/
        landing_is_target: true
        outline_closed: true

      - title: Experimental Packages
        subtitle: Community packages from TWINSERV that are not yet ready for use in a program
        landing_page: /tB/Packages/Experimental/
        landing_is_target: true
        outline_closed: true

      - title: ArrayListLib Package
        subtitle: A list class in place of the ArrayList of .NET
        landing_page: /tB/Packages/Contributed/ArrayListLib/
        page: /tB/Packages/Contributed/ArrayListLib/
        landing_is_target: true
        outline_closed: true

      - title: BigNumberLib Package
        subtitle: Arbitrary-precision signed integer arithmetic
        landing_page: /tB/Packages/Contributed/BigNumberLib/
        page: /tB/Packages/Contributed/BigNumberLib/
        landing_is_target: true
        outline_closed: true

      - title: TBMANLIB Package
        subtitle: A toolkit of helpers for JSON, logs, INI files, strings, bytes, files and dictionaries
        landing_page: /tB/Packages/Contributed/TBMANLIB/
        page: /tB/Packages/Contributed/TBMANLIB/
        landing_is_target: true
        outline_closed: true

      - title: TBMANLIB_Aes Package
        subtitle: AES encryption of text and byte arrays, through the Windows Crypto API and CNG
        landing_page: /tB/Packages/Contributed/TBMANLIB_Aes/
        page: /tB/Packages/Contributed/TBMANLIB_Aes/
        landing_is_target: true
        outline_closed: true

      - title: TBMANLIB_ConsoleComponents Package
        subtitle: Text-interface components for console programs, drawn into the buffer of TBMANLIB_ConsoleCore
        landing_page: /tB/Packages/Contributed/TBMANLIB_ConsoleComponents/
        page: /tB/Packages/Contributed/TBMANLIB_ConsoleComponents/
        landing_is_target: true
        outline_closed: true

      - title: TBMANLIB_ConsoleCore Package
        subtitle: A console library with colours, UTF-8 and a full-screen mode
        landing_page: /tB/Packages/Contributed/TBMANLIB_ConsoleCore/
        page: /tB/Packages/Contributed/TBMANLIB_ConsoleCore/
        landing_is_target: true
        outline_closed: true

      - title: TBMANLIB_Diagnostic Package
        subtitle: A diagnostic report of the computer and its processes, as text, JSON or HTML
        landing_page: /tB/Packages/Contributed/TBMANLIB_Diagnostic/
        page: /tB/Packages/Contributed/TBMANLIB_Diagnostic/
        landing_is_target: true
        outline_closed: true

      - title: TBMANLIB_Dialog Package
        subtitle: Open, Save, folder, Color, Font, Print and other dialogs in classes, with file filters and path helpers
        landing_page: /tB/Packages/Contributed/TBMANLIB_Dialog/
        page: /tB/Packages/Contributed/TBMANLIB_Dialog/
        landing_is_target: true
        outline_closed: true

      - title: TBMANLIB_Xml Package
        subtitle: XML documents parsed, edited and written, in twinBASIC code
        landing_page: /tB/Packages/Contributed/TBMANLIB_Xml/
        page: /tB/Packages/Contributed/TBMANLIB_Xml/
        landing_is_target: true
        outline_closed: true

      - title: WinReg Package
        subtitle: Registry keys and values, read, written, deleted and enumerated
        landing_page: /tB/Packages/Contributed/WinReg/
        page: /tB/Packages/Contributed/WinReg/
        landing_is_target: true
        outline_closed: true

      - title: xCalendar Package
        subtitle: A calendar control, in place of the Calendar control of MSCAL.OCX
        landing_page: /tB/Packages/Contributed/xCalendar/
        page: /tB/Packages/Contributed/xCalendar/
        landing_is_target: true
        outline_closed: true

  - title: Appendices
    outline_closed: false
    
    chapters:
      - title: Documentation Development
        subtitle: How does the documentation builder work and how to use it
        landing_page: /Documentation/Development/
        page: /Documentation/Development/
        landing_is_target: true
        outline_closed: true

left_out:
  - reason: The site's error page
    page: /404.html
    no_descent: true

  - reason: The Reference Section's index; the book's own parts and outline replace it
    page: /Reference
    no_descent: true

  - reason: Links to video recordings, with nothing to read in print
    page: /Videos

  - reason: Download links, with nothing to read in print
    page: /Downloads

  - reason: Time-limited community contests
    page: /Challenges

  - reason: IDE pages that are still screenshots and the labels they show, or headings with nothing under them
    no_descent: true
    pages:
      - /tB/IDE/AddIns/Community
      - /tB/IDE/Reference/Menu
      - /tB/IDE/Reference/Menu/AddIns
      - /tB/IDE/Reference/Menu/Help

  - reason: IDE pages that are complete but too short, or too much a list, to earn space in print yet
    no_descent: true
    pages:
      - /tB/IDE/Reference/StatusBar
      - /tB/IDE/Reference
      - /tB/IDE/Project/Webpage
      - /tB/IDE/Project/Splash
      - /tB/IDE/Project/PackagePublishing
      - /tB/IDE/AddIns/GlobalSearch
      - /tB/IDE/Reference/Menu/File
      - /tB/IDE/Reference/Menu/Edit
      - /tB/IDE/Reference/Menu/Project
      - /tB/IDE/Reference/Menu/Format
      - /tB/IDE/Reference/Menu/Run
      - /tB/IDE/Reference/Menu/Debug
      - /tB/IDE/Reference/Menu/View
      - /tB/IDE/Reference/Menu/Tools
      - /tB/IDE/Reference/Menu/Window     # ~800 lines of shortcut JSON that would print unfolded