[ { "path": ".cargo/config.toml", "content": "[alias]\nxtask = \"run --manifest-path=crates/xtask/Cargo.toml --\"\n" }, { "path": ".git-blame-ignore-revs", "content": "# Use `git config blame.ignorerevsfile .git-blame-ignore-revs` to make `git blame` ignore the following commits.\n\n# rustfmt\nad0794a0bd692e4f2ff23b85e361889620e93f51\n# rustfmt and use_try_shorthand\n75bbd55128083897d40c3f5265cc5b1f10314ddb\n# rustfmt\n382fc4139b96bde3c4b8875b499c720eabc89c6a\n# rustfmt\n154e0fb3080c6ffc225b0d47b5d835e589789892\n# rustfmt\n5835da243244bfc5c95c6c6db96f453da4bb5740\n# rustfmt\nfd9d27e082f5e9eea50e4fa9fa3a22060d02c66b\n# rustfmt\n1d69ccae4854f13552d452d0bffef95cbff70364\n# rustfmt\n3688f73052454bf510a5acc85cf55aae450c6e46\n# rustfmt\n742dbbc91700dce1b7d910bca6b3e10a5ae46b86\n# rustfmt 1.38\nb88839cc25a6fd1c782101e94318959e8079bb20\n# rustfmt 1.40\n2f59943c04f0aa204a9238d6a699ba9cc06c88d9\n# Rustfmt for 2024\nc7b67e363bb9ce3383636ee615e8e761bf185b33\n" }, { "path": ".gitattributes", "content": "[attr]rust text eol=lf whitespace=tab-in-indent,trailing-space,tabwidth=4\n\n* text=auto eol=lf\n*.rs rust\n*.woff binary\n*.ttf binary\n*.otf binary\n*.png binary\n*.eot binary\n*.woff2 binary\n" }, { "path": ".github/ISSUE_TEMPLATE/bug_report.yml", "content": "name: Bug Report\ndescription: Create a report to help us improve\nlabels: [\"C-bug\"]\nbody:\n - type: markdown\n attributes:\n value: Thanks for filing a 🐛 bug report 😄!\n - type: textarea\n id: problem\n attributes:\n label: Problem\n description: >\n Please provide a clear and concise description of what the bug is,\n including what currently happens and what you expected to happen.\n validations:\n required: true\n - type: textarea\n id: steps\n attributes:\n label: Steps\n description: Please list the steps to reproduce the bug.\n placeholder: |\n 1.\n 2.\n 3.\n - type: textarea\n id: possible-solutions\n attributes:\n label: Possible Solution(s)\n description: >\n Not obligatory, but suggest a fix/reason for the bug,\n or ideas how to implement the addition or change.\n - type: textarea\n id: notes\n attributes:\n label: Notes\n description: Provide any additional notes that might be helpful.\n - type: textarea\n id: version\n attributes:\n label: Version\n description: >\n Please paste the output of running `mdbook --version` or which version\n of the library you are using.\n render: text\n" }, { "path": ".github/ISSUE_TEMPLATE/feature_request.yml", "content": "name: Enhancement\ndescription: Suggest an idea for enhancing mdBook\nlabels: [\"C-enhancement\"]\nbody:\n - type: markdown\n attributes:\n value: |\n Thanks for filing a 🙋 feature request 😄!\n - type: textarea\n id: problem\n attributes:\n label: Problem\n description: >\n Please provide a clear description of your use case and the problem\n this feature request is trying to solve.\n validations:\n required: true\n - type: textarea\n id: solution\n attributes:\n label: Proposed Solution\n description: >\n Please provide a clear and concise description of what you want to happen.\n - type: textarea\n id: notes\n attributes:\n label: Notes\n description: Provide any additional context or information that might be helpful.\n" }, { "path": ".github/ISSUE_TEMPLATE/question.yml", "content": "name: Question\ndescription: Have a question on how to use mdBook?\nlabels: [\"C-question\"]\nbody:\n - type: markdown\n attributes:\n value: |\n Got a question on how to do something with mdBook?\n - type: textarea\n id: question\n attributes:\n label: Question\n description: >\n Enter your question here. Please try to provide as much detail as possible.\n validations:\n required: true\n - type: textarea\n id: version\n attributes:\n label: Version\n description: >\n Please paste the output of running `mdbook --version` or which version\n of the library you are using.\n render: text\n" }, { "path": ".github/renovate.json5", "content": "{\n schedule: ['before 5am on the first day of the month'],\n // Raise from default of 2 to reduce trickle.\n prHourlyLimit: 6,\n dependencyDashboard: true,\n // Creates PRs if this renovate config file needs updating.\n configMigration: true,\n ignorePaths: [\n 'guide/src/for_developers/mdbook-wordcount/',\n ],\n customManagers: [\n // Custom manager to extract the version of cargo-semver-checks from the workflow.\n {\n customType: 'regex',\n managerFilePatterns: [\n '/^.github.workflows.main.yml$/',\n ],\n matchStrings: [\n 'cargo-semver-checks.releases.download.v(?\\\\d+\\\\.\\\\d+(\\\\.\\\\d+)?)',\n ],\n depNameTemplate: 'cargo-semver-checks',\n packageNameTemplate: 'obi1kenobi/cargo-semver-checks',\n datasourceTemplate: 'github-releases',\n },\n ],\n packageRules: [\n // The next two rules disable compatible dependency updates. I wasn't\n // able to get Renovate to be able to update Cargo.toml for compatible\n // updates only, update all transitive dependencies, and do that all\n // in a single PR. Instead, the `update-dependencies.sh` will handle\n // that.\n {\n matchManagers: ['cargo'],\n matchUpdateTypes: ['patch'],\n enabled: false,\n },\n {\n matchManagers: ['cargo'],\n matchCurrentVersion: '>=1.0.0',\n matchUpdateTypes: ['minor'],\n enabled: false,\n },\n // Allow minor updates for pre-1.0 dependencies (semver-breaking)\n {\n matchManagers: ['cargo'],\n matchCurrentVersion: '<1.0.0',\n matchUpdateTypes: ['minor'],\n },\n // Allow major updates for stable dependencies (semver-breaking)\n {\n matchManagers: ['cargo'],\n matchCurrentVersion: '>=1.0.0',\n matchUpdateTypes: ['major'],\n },\n // Update cargo-semver-checks when a new version is available.\n {\n commitMessageTopic: 'cargo-semver-checks',\n matchManagers: [\n 'custom.regex',\n ],\n matchDepNames: [\n 'cargo-semver-checks',\n ],\n extractVersion: '^v(?\\\\d+\\\\.\\\\d+\\\\.\\\\d+)',\n schedule: [\n '* * * * *',\n ],\n internalChecksFilter: 'strict',\n },\n ]\n}\n" }, { "path": ".github/workflows/deploy.yml", "content": "name: Deploy\non:\n release:\n types: [created]\n\ndefaults:\n run:\n shell: bash\n\npermissions:\n contents: write\n\njobs:\n release:\n runs-on: ${{ matrix.os }}\n strategy:\n matrix:\n include:\n - target: aarch64-unknown-linux-musl\n os: ubuntu-22.04\n - target: x86_64-unknown-linux-gnu\n os: ubuntu-22.04\n - target: x86_64-unknown-linux-musl\n os: ubuntu-22.04\n - target: x86_64-apple-darwin\n os: macos-latest\n - target: aarch64-apple-darwin\n os: macos-latest\n - target: x86_64-pc-windows-msvc\n os: windows-latest\n name: Deploy ${{ matrix.target }}\n steps:\n - uses: actions/checkout@v5\n - name: Install Rust\n run: ci/install-rust.sh stable ${{ matrix.target }}\n - name: Build asset\n run: ci/make-release-asset.sh ${{ matrix.os }} ${{ matrix.target }}\n - name: Update release with new asset\n env:\n GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}\n run: gh release upload $MDBOOK_TAG $MDBOOK_ASSET\n pages:\n name: GitHub Pages\n runs-on: ubuntu-latest\n steps:\n - uses: actions/checkout@v5\n - name: Install Rust (rustup)\n run: rustup update stable --no-self-update && rustup default stable\n - name: Deploy the User Guide to GitHub Pages using the gh-pages branch\n run: ci/publish-guide.sh\n publish:\n name: Publish to crates.io\n runs-on: ubuntu-latest\n permissions:\n # Required for OIDC token exchange\n id-token: write\n environment: publish\n steps:\n - uses: actions/checkout@v5\n - name: Install Rust (rustup)\n run: rustup update stable --no-self-update && rustup default stable\n - name: Authenticate with crates.io\n id: auth\n uses: rust-lang/crates-io-auth-action@v1\n - name: Publish\n env:\n CARGO_REGISTRY_TOKEN: ${{ steps.auth.outputs.token }}\n run: cargo publish --workspace --no-verify\n" }, { "path": ".github/workflows/main.yml", "content": "name: CI\non:\n pull_request:\n merge_group:\n\njobs:\n test:\n runs-on: ${{ matrix.os }}\n strategy:\n matrix:\n include:\n - name: stable linux\n os: ubuntu-latest\n rust: stable\n target: x86_64-unknown-linux-gnu\n - name: beta linux\n os: ubuntu-latest\n rust: beta\n target: x86_64-unknown-linux-gnu\n - name: nightly linux\n os: ubuntu-latest\n rust: nightly\n target: x86_64-unknown-linux-gnu\n - name: stable x86_64-unknown-linux-musl\n os: ubuntu-22.04\n rust: stable\n target: x86_64-unknown-linux-musl\n - name: stable x86_64 macos\n os: macos-latest\n rust: stable\n target: x86_64-apple-darwin\n - name: stable aarch64 macos\n os: macos-latest\n rust: stable\n target: aarch64-apple-darwin\n - name: stable windows-msvc\n os: windows-latest\n rust: stable\n target: x86_64-pc-windows-msvc\n - name: msrv\n os: ubuntu-22.04\n # sync MSRV with docs: guide/src/guide/installation.md and Cargo.toml\n rust: 1.88.0\n target: x86_64-unknown-linux-gnu\n name: ${{ matrix.name }}\n steps:\n - uses: actions/checkout@v5\n - name: Install Rust\n run: bash ci/install-rust.sh ${{ matrix.rust }} ${{ matrix.target }}\n - name: Build and run tests\n run: cargo test --workspace --locked --target ${{ matrix.target }}\n - name: Test no default\n run: cargo test --workspace --no-default-features --target ${{ matrix.target }}\n\n aarch64-cross-builds:\n runs-on: ubuntu-22.04\n steps:\n - uses: actions/checkout@v5\n - name: Install Rust\n run: bash ci/install-rust.sh stable aarch64-unknown-linux-musl\n - name: Build\n run: cargo build --locked --target aarch64-unknown-linux-musl\n\n rustfmt:\n name: Rustfmt\n runs-on: ubuntu-latest\n steps:\n - uses: actions/checkout@v5\n - name: Install Rust\n run: rustup update stable && rustup default stable && rustup component add rustfmt\n - run: cargo fmt --check\n\n gui:\n name: GUI tests\n runs-on: ubuntu-latest\n steps:\n - uses: actions/checkout@v5\n - name: Install Rust\n run: bash ci/install-rust.sh stable x86_64-unknown-linux-gnu\n - name: Install npm\n uses: actions/setup-node@v6\n with:\n node-version: 24\n - name: Install browser-ui-test\n run: npm install\n - name: Run eslint\n run: npm run lint\n - name: Build and run tests (+ GUI)\n run: cargo test --locked --target x86_64-unknown-linux-gnu --test gui\n\n # Ensure there are no clippy warnings\n clippy:\n runs-on: ubuntu-latest\n steps:\n - uses: actions/checkout@v5\n - name: Install Rust\n run: bash ci/install-rust.sh stable x86_64-unknown-linux-gnu\n - run: rustup component add clippy\n - run: cargo clippy --workspace --all-targets --no-deps -- -D warnings\n\n docs:\n name: Check API docs\n runs-on: ubuntu-latest\n steps:\n - uses: actions/checkout@v5\n - name: Install Rust\n run: bash ci/install-rust.sh stable x86_64-unknown-linux-gnu\n - name: Ensure intradoc links are valid\n run: cargo doc --workspace --document-private-items --no-deps\n env:\n RUSTDOCFLAGS: -D warnings\n\n check-version-bump:\n name: Check version bump\n runs-on: ubuntu-latest\n steps:\n - uses: actions/checkout@v5\n - run: rustup update stable && rustup default stable\n - name: Install cargo-semver-checks\n run: |\n mkdir installed-bins\n curl -Lf https://github.com/obi1kenobi/cargo-semver-checks/releases/download/v0.47.0/cargo-semver-checks-x86_64-unknown-linux-gnu.tar.gz \\\n | tar -xz --directory=./installed-bins\n echo `pwd`/installed-bins >> $GITHUB_PATH\n - run: cargo semver-checks --workspace\n\n # The success job is here to consolidate the total success/failure state of\n # all other jobs. This job is then included in the GitHub branch protection\n # rule which prevents merges unless all other jobs are passing. This makes\n # it easier to manage the list of jobs via this yml file and to prevent\n # accidentally adding new jobs without also updating the branch protections.\n success:\n name: Success gate\n if: always()\n needs:\n - test\n - rustfmt\n - aarch64-cross-builds\n - gui\n - clippy\n - docs\n - check-version-bump\n runs-on: ubuntu-latest\n steps:\n - run: jq --exit-status 'all(.result == \"success\")' <<< '${{ toJson(needs) }}'\n - name: Done\n run: exit 0\n" }, { "path": ".github/workflows/update-dependencies.yml", "content": "name: Update dependencies\non:\n schedule:\n - cron: '0 0 1 * *'\n workflow_dispatch:\n\njobs:\n update:\n name: Update dependencies\n runs-on: ubuntu-latest\n if: github.repository == 'rust-lang/mdBook'\n steps:\n - uses: actions/checkout@v5\n - name: Install Rust\n run: bash ci/install-rust.sh stable x86_64-unknown-linux-gnu\n - name: Install cargo-edit\n run: cargo install cargo-edit --locked\n - name: Update dependencies\n run: ci/update-dependencies.sh\n env:\n GH_TOKEN: ${{ github.token }}\n" }, { "path": ".gitignore", "content": "target\n\n# MacOS temp file\n.DS_Store\n\nbook-test\nguide/book\n\n.vscode\ntests/dummy_book/book/\ntests/gui/books/*/book/\ntests/testsuite/*/*/book/\n\n# Ignore Jetbrains specific files.\n.idea/\n\n# Ignore Vim temporary and swap files.\n*.sw?\n*~\n\n# GUI tests\nnode_modules\npackage-lock.json\npackage.json\n" }, { "path": "CHANGELOG.md", "content": "# Changelog\n\n## mdBook 0.5.2\n[v0.5.1...v0.5.2](https://github.com/rust-lang/mdBook/compare/v0.5.1...v0.5.2)\n\n### Changed\n\n- Updated Rust crate html5ever to 0.36.0.\n [#2970](https://github.com/rust-lang/mdBook/pull/2970)\n- Updated cargo dependencies.\n [#2969](https://github.com/rust-lang/mdBook/pull/2969)\n\n### Fixed\n\n- Fixed repeated error message when HTML config is invalid in `mdbook serve`.\n [#2983](https://github.com/rust-lang/mdBook/pull/2983)\n- Fixed sidebar scroll position when heading nav is involved.\n [#2982](https://github.com/rust-lang/mdBook/pull/2982)\n- Fixed color for rustdoc error messages.\n [#2981](https://github.com/rust-lang/mdBook/pull/2981)\n- Fixed usage of custom preprocessors with `MDBook::test`.\n [#2980](https://github.com/rust-lang/mdBook/pull/2980)\n\n## mdBook 0.5.1\n[v0.5.0...v0.5.1](https://github.com/rust-lang/mdBook/compare/v0.5.0...v0.5.1)\n\n### Changed\n- Changed the scrollbar background to be transparent.\n [#2932](https://github.com/rust-lang/mdBook/pull/2932)\n- Ignore invalid top-level environment variable config keys. This allows setting things like `MDBOOK_VERSION` to not cause an error.\n [#2952](https://github.com/rust-lang/mdBook/pull/2952)\n\n### Fixed\n- Fixed the sidebar heading nav to have the correct nesting levels.\n [#2953](https://github.com/rust-lang/mdBook/pull/2953)\n- Various Font Awesome fixes and improvements.\n [#2951](https://github.com/rust-lang/mdBook/pull/2951)\n\n## mdBook 0.5.0\n[v0.4.52...v0.5.0](https://github.com/rust-lang/mdBook/compare/v0.4.52...v0.5.0)\n\nThe 0.5.0 release is the next major release of mdBook, containing over 130 PRs since 0.4.52! The primary focus for this release has been an evolution of the Rust APIs to make it easier to maintain, to evolve in a backwards-compatible fashion, to clean up some things that have accumulated over time, and to significantly improve the performance and compile-times.\n\nThis release also includes many new features described below.\n\nWe have prepared a [0.5 Migration Guide](#05-migration-guide) to help existing authors switch from 0.4.\n\nThe final 0.5.0 release only contains the following changes since [0.5.0-beta.2](#mdbook-050-beta2):\n\n- Added error handling to environment config handling. This checks that environment variables starting with `MDBOOK_` are correctly specified instead of silently ignoring. This also fixed being able to replace entire top-level tables like `MDBOOK_OUTPUT`.\n [#2942](https://github.com/rust-lang/mdBook/pull/2942)\n\n## 0.5 Migration Guide\n\nThe 0.5 release contains several breaking changes from the 0.4 release. Preprocessors and renderers will need to be migrated to continue to work with this release. After updating your configuration, it is recommended to carefully compare and review how your book renders to ensure everything is working correctly.\n\nIf you have overridden any of the theme files, you will likely need to update them to match the current version.\n\nSee the entries below for [mdBook 0.5.0-alpha.1](#mdbook-050-alpha1), [mdBook 0.5.0-beta.1](#mdbook-050-beta1), and [mdBook 0.5.0-beta.2](#mdbook-050-beta2) for a more complete list of changes and fixes.\n\nThe following is a summary of the changes that may require your attention when updating to 0.5:\n\n### Major additions\n\n- Added sidebar heading navigation. This includes the `output.html.sidebar-header-nav` option to disable it.\n [#2822](https://github.com/rust-lang/mdBook/pull/2822)\n- Added support for definition lists. These are enabled by default, with the option `output.html.definition-lists` to disable it. See [docs](https://rust-lang.github.io/mdBook/format/markdown.html#definition-lists) for more.\n [#2847](https://github.com/rust-lang/mdBook/pull/2847)\n- Added support for admonitions. These are enabled by default, with the option `output.html.admonitions` to disable it. See [docs](https://rust-lang.github.io/mdBook/format/markdown.html#admonitions) for more.\n [#2851](https://github.com/rust-lang/mdBook/pull/2851)\n- Links on the print page now link to elements on the print page instead of linking out to the individual chapters.\n [#2844](https://github.com/rust-lang/mdBook/pull/2844)\n\n### Config changes\n\n- Unknown fields in config are now an error.\n [#2787](https://github.com/rust-lang/mdBook/pull/2787)\n [#2801](https://github.com/rust-lang/mdBook/pull/2801)\n- Removed `curly-quotes`, use `output.html.smart-punctuation` instead.\n [#2788](https://github.com/rust-lang/mdBook/pull/2788)\n- Removed `output.html.copy-fonts`. The default fonts are now always copied unless you override the `theme/fonts/fonts.css` file.\n [#2790](https://github.com/rust-lang/mdBook/pull/2790)\n- If the `command` path for a renderer or preprocessor is relative, it is now always relative to the book root.\n [#2792](https://github.com/rust-lang/mdBook/pull/2792)\n [#2796](https://github.com/rust-lang/mdBook/pull/2796)\n- Added the `optional` field for preprocessors. The default is `false`, so this also means it is an error by default if the preprocessor is missing.\n [#2797](https://github.com/rust-lang/mdBook/pull/2797)\n- `output.html.smart-punctuation` is now `true` by default.\n [#2810](https://github.com/rust-lang/mdBook/pull/2810)\n- `output.html.hash-files` is now `true` by default.\n [#2820](https://github.com/rust-lang/mdBook/pull/2820)\n- Removed support for google-analytics. Use a theme extension (like `head.hbs`) if you need to continue to support this.\n [#2776](https://github.com/rust-lang/mdBook/pull/2776)\n- Removed the `book.multilingual` field. This was never used.\n [#2775](https://github.com/rust-lang/mdBook/pull/2775)\n- Removed the very old legacy config support. Warnings have been displayed in previous versions on how to migrate.\n [#2783](https://github.com/rust-lang/mdBook/pull/2783)\n- Top-level config values set from the environment like `MDBOOK_BOOK` now *replace* the contents of the top-level table instead of merging into it.\n [#2942](https://github.com/rust-lang/mdBook/pull/2942)\n- Invalid environment variables are now rejected. Previously unknown keys like `MDBOOK_FOO` would be ignored, or keys or invalid values inside objects like the `[book]` table would be ignored.\n [#2942](https://github.com/rust-lang/mdBook/pull/2942)\n\n### Theme changes\n\n- Replaced the `{{#previous}}` and `{{#next}}` handlebars helpers with simple objects that contain the previous and next values.\n [#2794](https://github.com/rust-lang/mdBook/pull/2794)\n- Removed the `{{theme_option}}` handlebars helper. It has not been used for a while.\n [#2795](https://github.com/rust-lang/mdBook/pull/2795)\n\n### Rendering changes\n\n- Updated to a newer version of `pulldown-cmark`. This brings a large number of fixes to markdown processing.\n [#2401](https://github.com/rust-lang/mdBook/pull/2401)\n- The font-awesome font is no longer loaded as a font. Instead, the corresponding SVG is embedded in the output for the corresponding `` tags. Additionally, a handlebars helper has been added for the `hbs` files. This also updates the version from 4.7.0 to 6.2.0, which means some of the icon names and styles have changed. Most of the free icons are in the \"solid\" set. See the [free icon set](https://fontawesome.com/v6/search) for the available icons.\n [#1330](https://github.com/rust-lang/mdBook/pull/1330)\n- Changed all internal HTML IDs to have an `mdbook-` prefix. This helps avoid namespace conflicts with header IDs.\n [#2808](https://github.com/rust-lang/mdBook/pull/2808)\n- There is a new internal HTML rendering pipeline. This is primarily intended to give mdBook more flexibility in generating its HTML output. This resulted in some small changes to the HTML structure. HTML parsing may now be more strict than before.\n [#2844](https://github.com/rust-lang/mdBook/pull/2844)\n- Links on the print page now link to elements on the print page instead of linking out to the individual chapters.\n [#2844](https://github.com/rust-lang/mdBook/pull/2844)\n- Added support for definition lists. These are enabled by default, with the option `output.html.definition-lists` to disable it.\n [#2847](https://github.com/rust-lang/mdBook/pull/2847)\n- Added support for admonitions. These are enabled by default, with the option `output.html.admonitions` to disable it.\n [#2851](https://github.com/rust-lang/mdBook/pull/2851)\n- Header ID generation has some minor changes to bring the ID generation closer to other tools and sites:\n - IDs now use Unicode lowercase instead of ASCII lowercase.\n [#2922](https://github.com/rust-lang/mdBook/pull/2922)\n - Headers that start or end with HTML characters like `<`, `&`, or `>` now replace those characters in the link ID with `-` instead of being stripped.\n [#2844](https://github.com/rust-lang/mdBook/pull/2844)\n- Headers are no longer modified if the tag is manually written HTML.\n [#2913](https://github.com/rust-lang/mdBook/pull/2913)\n\n### CLI changes\n\n- Removed the `--dest-dir` option to `mdbook test`. It was unused since `mdbook test` does not generate output.\n [#2805](https://github.com/rust-lang/mdBook/pull/2805)\n- Changed CLI `--dest-dir` to be relative to the current directory, not the book root.\n [#2806](https://github.com/rust-lang/mdBook/pull/2806)\n\n### Rust API\n\n- The Rust API has been split into several crates ([#2766](https://github.com/rust-lang/mdBook/pull/2766)). In summary, the different crates are:\n - `mdbook` — The CLI binary.\n - [`mdbook-driver`](https://docs.rs/mdbook-driver/latest/mdbook_driver/) — The high-level library for running mdBook, primarily through the `MDBook` type. If you are driving mdBook programmatically, this is the crate you want.\n - [`mdbook-preprocessor`](https://docs.rs/mdbook-preprocessor/latest/mdbook_preprocessor/) — Support for implementing preprocessors. If you have a preprocessor, then this is the crate you should depend on.\n - [`mdbook-renderer`](https://docs.rs/mdbook-renderer/latest/mdbook_renderer/) — Support for implementing renderers. If you have a custom renderer, this is the crate you should depend on.\n - [`mdbook-markdown`](https://docs.rs/mdbook-markdown/latest/mdbook_markdown/) — The Markdown renderer. If you are processing markdown, this is the crate you should depend on. This is essentially a thin wrapper around `pulldown-cmark`, and re-exports that crate so that you can ensure the version stays in sync with mdBook.\n - [`mdbook-summary`](https://docs.rs/mdbook-summary/latest/mdbook_summary/) — The `SUMMARY.md` parser.\n - [`mdbook-html`](https://docs.rs/mdbook-html/latest/mdbook_html/) — The HTML renderer.\n - [`mdbook-core`](https://docs.rs/mdbook-core/latest/mdbook_core/) — An internal library that is used by the other crates for shared types. You should not depend on this crate directly since types from this crate are re-exported from the other crates as appropriate.\n- Changes to `Config`:\n - [`Config::get`](https://docs.rs/mdbook-core/latest/mdbook_core/config/struct.Config.html#method.get) is now generic over the return value, using `serde` to deserialize the value. It also returns a `Result` to handle deserialization errors. [#2773](https://github.com/rust-lang/mdBook/pull/2773)\n - [`Config::set`](https://docs.rs/mdbook-core/latest/mdbook_core/config/struct.Config.html#method.set) now validates that the config keys and values are valid.\n [#2942](https://github.com/rust-lang/mdBook/pull/2942)\n - [`Config::update_from_env`](https://docs.rs/mdbook-core/latest/mdbook_core/config/struct.Config.html#method.update_from_env) now returns a `Result` to indicate any errors.\n [#2942](https://github.com/rust-lang/mdBook/pull/2942)\n - Removed `Config::get_deserialized`. Use `Config::get` instead.\n - Removed `Config::get_deserialized_opt`. Use `Config::get` instead.\n - Removed `Config::get_mut`. Use `Config::set` instead.\n - Removed deprecated `Config::get_deserialized_opt`. Use `Config::get` instead.\n - Removed `Config::get_renderer`. Use `Config::get` instead.\n - Removed `Config::get_preprocessor`. Use `Config::get` instead.\n- Public types have been switch to use the `#[non_exhaustive]` attribute to help allow them to change in a backwards-compatible way.\n [#2779](https://github.com/rust-lang/mdBook/pull/2779)\n [#2823](https://github.com/rust-lang/mdBook/pull/2823)\n- Changed `MDBook` `with_renderer`/`with_preprocessor` to overwrite the entry if an extension of the same name is already loaded. This allows the caller to replace an entry.\n [#2802](https://github.com/rust-lang/mdBook/pull/2802)\n- Added `MarkdownOptions` struct to specify settings for markdown rendering for `mdbook_markdown::new_cmark_parser`.\n [#2809](https://github.cocm/rust-lang/mdBook/pull/2809)\n- Renamed `Book::sections` to `Book::items`.\n [#2813](https://github.com/rust-lang/mdBook/pull/2813)\n- `mdbook::book::load_book` is now private. Instead, use one of the `MDBook` load functions like `MDBook::load_with_config`.\n- Removed `HtmlConfig::smart_punctuation` method, use the field of the same name.\n- `CmdPreprocessor::parse_input` moved to `mdbook_preprocessor::parse_input`.\n- `Preprocessor::supports_renderer` now returns a `Result` instead of `bool` to be able to handle errors.\n- Most of the types from the `theme` module are now private. The `Theme` struct is still exposed for working with themes.\n- Various functions in the `utils::fs` module have been removed, renamed, or reworked.\n- Most of the functions in the `utils` module have been moved, removed, or made private.\n\n## mdBook 0.5.0-beta.2\n[v0.5.0-beta.1...v0.5.0-beta.2](https://github.com/rust-lang/mdBook/compare/v0.5.0-beta.1...v0.5.0-beta.2)\n\n### Added\n\n- Added a warning when a Font Awesome icon is missing.\n [#2915](https://github.com/rust-lang/mdBook/pull/2915)\n- Added some trace logging for event processing.\n [#2911](https://github.com/rust-lang/mdBook/pull/2911)\n- Added `Config::contains_key`.\n [#2910](https://github.com/rust-lang/mdBook/pull/2910)\n\n### Changed\n\n- Heading IDs are now lowercase.\n [#2922](https://github.com/rust-lang/mdBook/pull/2922)\n- Updated cargo dependencies.\n [#2916](https://github.com/rust-lang/mdBook/pull/2916)\n- Removed italics for in quotes/comments in code blocks with the `ayu` theme.\n [#2904](https://github.com/rust-lang/mdBook/pull/2904)\n- Exposed \"search\" feature from mdbook-driver.\n [#2907](https://github.com/rust-lang/mdBook/pull/2907)\n\n### Fixed\n\n- Fixed rust fenced code blocks with an indent.\n [#2905](https://github.com/rust-lang/mdBook/pull/2905)\n- Headers and `dt` tags are no longer modified if the tag is manually written HTML.\n [#2913](https://github.com/rust-lang/mdBook/pull/2913)\n- Fixed print page links for internal links to non-chapters.\n [#2914](https://github.com/rust-lang/mdBook/pull/2914)\n- Better handling for unbalanced HTML tags.\n [#2924](https://github.com/rust-lang/mdBook/pull/2924)\n- Handle unclosed HTML tags inside a markdown element.\n [#2927](https://github.com/rust-lang/mdBook/pull/2927)\n- Fixed missing font-awesome icons in the guide.\n [#2926](https://github.com/rust-lang/mdBook/pull/2926)\n- Hide the sidebar resize indicator when JS isn't available.\n [#2923](https://github.com/rust-lang/mdBook/pull/2923)\n\n## mdBook 0.5.0-beta.1\n[v0.5.0-alpha.1...v0.5.0-beta.1](https://github.com/rust-lang/mdBook/compare/v0.5.0-alpha.1...v0.5.0-beta.1)\n\n### Changed\n\n- Reworked the look of the header navigation.\n [#2898](https://github.com/rust-lang/mdBook/pull/2898)\n- Update cargo dependencies.\n [#2896](https://github.com/rust-lang/mdBook/pull/2896)\n- Improved the heading nav debug.\n [#2892](https://github.com/rust-lang/mdBook/pull/2892)\n\n### Fixed\n\n- Fixed error message for config.get deserialization error.\n [#2902](https://github.com/rust-lang/mdBook/pull/2902)\n- Filter `` tags from sidebar heading nav.\n [#2899](https://github.com/rust-lang/mdBook/pull/2899)\n- Avoid divide-by-zero in heading nav computation\n [#2891](https://github.com/rust-lang/mdBook/pull/2891)\n- Fixed heading nav with folded chapters.\n [#2893](https://github.com/rust-lang/mdBook/pull/2893)\n\n## mdBook 0.5.0-alpha.1\n[v0.4.52...v0.5.0-alpha.1](https://github.com/rust-lang/mdBook/compare/v0.4.52...v0.5.0-alpha.1)\n\n### Added\n\n- The location of the generated HTML book is now displayed on the console.\n [#2729](https://github.com/rust-lang/mdBook/pull/2729)\n- ❗ Added the `optional` field for preprocessors. The default is `false`, so this also changes it so that it is an error if the preprocessor is missing.\n [#2797](https://github.com/rust-lang/mdBook/pull/2797)\n- ❗ Added `MarkdownOptions` struct to specify settings for markdown rendering.\n [#2809](https://github.cocm/rust-lang/mdBook/pull/2809)\n- Added sidebar heading navigation. This includes the `output.html.sidebar-header-nav` option to disable it.\n [#2822](https://github.com/rust-lang/mdBook/pull/2822)\n- Added the mdbook version to the guide.\n [#2826](https://github.com/rust-lang/mdBook/pull/2826)\n- Added `Book::chapters` and `Book::for_each_chapter_mut` to more conveniently iterate over chapters (instead of all items).\n [#2838](https://github.com/rust-lang/mdBook/pull/2838)\n- ❗ Added support for definition lists. These are enabled by default, with the option `output.html.definition-lists` to disable it.\n [#2847](https://github.com/rust-lang/mdBook/pull/2847)\n- ❗ Added support for admonitions. These are enabled by default, with the option `output.html.admonitions` to disable it.\n [#2851](https://github.com/rust-lang/mdBook/pull/2851)\n\n### Changed\n\n- ❗ The `mdbook` crate has been split into multiple crates.\n [#2766](https://github.com/rust-lang/mdBook/pull/2766)\n- The minimum Rust version has been updated to 1.88.\n [#2844](https://github.com/rust-lang/mdBook/pull/2844)\n- ❗ `pulldown-cmark` has been upgraded to 0.13.0, bringing a large number of fixes to markdown processing.\n [#2401](https://github.com/rust-lang/mdBook/pull/2401)\n- ❗ Switched public types to `non_exhaustive` to help allow them to change in a backwards-compatible way.\n [#2779](https://github.com/rust-lang/mdBook/pull/2779)\n [#2823](https://github.com/rust-lang/mdBook/pull/2823)\n- ❗ Unknown fields in config are now an error.\n [#2787](https://github.com/rust-lang/mdBook/pull/2787)\n [#2801](https://github.com/rust-lang/mdBook/pull/2801)\n- ❗ Changed `id_from_content` to be private.\n [#2791](https://github.com/rust-lang/mdBook/pull/2791)\n- ❗ Changed preprocessor `command` to use paths relative to the book root.\n [#2796](https://github.com/rust-lang/mdBook/pull/2796)\n- ❗ Replaced the `{{#previous}}` and `{{#next}}` handelbars navigation helpers with objects.\n [#2794](https://github.com/rust-lang/mdBook/pull/2794)\n- ❗ Use embedded SVG instead of fonts for icons, font-awesome 6.2.\n [#1330](https://github.com/rust-lang/mdBook/pull/1330)\n- The `book.src` field is no longer serialized if it is the default of \"src\".\n [#2800](https://github.com/rust-lang/mdBook/pull/2800)\n- ❗ Changed `MDBook` `with_renderer`/`with_preprocessor` to overwrite the entry if an extension of the same name is already loaded.\n [#2802](https://github.com/rust-lang/mdBook/pull/2802)\n- ❗ Changed CLI `--dest-dir` to be relative to the current directory, not the book root.\n [#2806](https://github.com/rust-lang/mdBook/pull/2806)\n- ❗ Changed all internal HTML IDs to have an `mdbook-` prefix. This helps avoid namespace conflicts with header IDs.\n [#2808](https://github.com/rust-lang/mdBook/pull/2808)\n- ❗ `output.html.smart-punctuation` is now `true` by default.\n [#2810](https://github.com/rust-lang/mdBook/pull/2810)\n- ❗ Renamed `Book::sections` to `Book::items`.\n [#2813](https://github.com/rust-lang/mdBook/pull/2813)\n- ❗ `output.html.hash-files` is now `true` by default.\n [#2820](https://github.com/rust-lang/mdBook/pull/2820)\n- Switched from `log` to `tracing`.\n [#2829](https://github.com/rust-lang/mdBook/pull/2829)\n- ❗ Rewrote the HTML rendering pipeline.\n [#2844](https://github.com/rust-lang/mdBook/pull/2844)\n- ❗ Links on the print page now link to elements on the print page instead of linking out to the individual chapters.\n [#2844](https://github.com/rust-lang/mdBook/pull/2844)\n- ❗ Moved theme copy to the Theme type and reduced visibility.\n [#2857](https://github.com/rust-lang/mdBook/pull/2857)\n- ❗ Cleaned up some fs-related utilities.\n [#2856](https://github.com/rust-lang/mdBook/pull/2856)\n- ❗ Moved `get_404_output_file` to `HtmlConfig`.\n [#2855](https://github.com/rust-lang/mdBook/pull/2855)\n- ❗ Moved `take_lines` functions to `mdbook-driver` and made private.\n [#2854](https://github.com/rust-lang/mdBook/pull/2854)\n- Updated dependencies.\n [#2793](https://github.com/rust-lang/mdBook/pull/2793)\n [#2869](https://github.com/rust-lang/mdBook/pull/2869)\n\n### Removed\n\n- ❗ Removed `toml` as a public dependency.\n [#2773](https://github.com/rust-lang/mdBook/pull/2773)\n- ❗ Removed the `book.multilingual` field. This was never used.\n [#2775](https://github.com/rust-lang/mdBook/pull/2775)\n- ❗ Removed support for google-analytics.\n [#2776](https://github.com/rust-lang/mdBook/pull/2776)\n- ❗ Removed the very old legacy config support.\n [#2783](https://github.com/rust-lang/mdBook/pull/2783)\n- ❗ Removed `curly-quotes`, use `output.html.smart-punctuation` instead.\n [#2788](https://github.com/rust-lang/mdBook/pull/2788)\n- Removed old warning about `book.json`.\n [#2789](https://github.com/rust-lang/mdBook/pull/2789)\n- ❗ Removed `output.html.copy-fonts`. The default fonts are now always copied unless you override the `theme/fonts/fonts.css` file.\n [#2790](https://github.com/rust-lang/mdBook/pull/2790)\n- ❗ Removed legacy relative renderer command paths. Relative renderer command paths now must always be relative to the book root.\n [#2792](https://github.com/rust-lang/mdBook/pull/2792)\n- ❗ Removed the `{{theme_option}}` handlebars helper. It has not been used for a while.\n [#2795](https://github.com/rust-lang/mdBook/pull/2795)\n- ❗ Removed the `--dest-dir` option to `mdbook test`.\n [#2805](https://github.com/rust-lang/mdBook/pull/2805)\n\n### Fixed\n\n- Fixed handling of multiple footnotes in a row.\n [#2807](https://github.com/rust-lang/mdBook/pull/2807)\n- Fixed ID collisions when the numeric suffix gets used.\n [#2846](https://github.com/rust-lang/mdBook/pull/2846)\n- Fixed missing css vars for no-js dark mode.\n [#2850](https://github.com/rust-lang/mdBook/pull/2850)\n\n## mdBook 0.4.52\n[v0.4.51...v0.4.52](https://github.com/rust-lang/mdBook/compare/v0.4.51...v0.4.52)\n\n**Note:** If you have a custom `index.hbs` theme file, it is recommended that you update it to the latest version to pick up the fixes in this release.\n\n### Added\n- Added the ability to redirect `#` HTML fragments using the existing `output.html.redirect` table.\n [#2747](https://github.com/rust-lang/mdBook/pull/2747)\n- Added the `rel=\"edit\"` attribute to the edit page button.\n [#2702](https://github.com/rust-lang/mdBook/pull/2702)\n\n### Changed\n- The search index is now only loaded when the search input is opened instead of always being loaded.\n [#2553](https://github.com/rust-lang/mdBook/pull/2553)\n [#2735](https://github.com/rust-lang/mdBook/pull/2735)\n- The `mdbook serve` command has switched its underlying server library from warp to axum.\n [#2748](https://github.com/rust-lang/mdBook/pull/2748)\n- Updated dependencies.\n [#2752](https://github.com/rust-lang/mdBook/pull/2752)\n\n### Fixed\n- The sidebar is now set to `display:none` when it is hidden in order to prevent the browser's search from thinking the sidebar's text is visible.\n [#2725](https://github.com/rust-lang/mdBook/pull/2725)\n- Fixed search index URL not updating correctly when `hash-files` is enabled.\n [#2742](https://github.com/rust-lang/mdBook/pull/2742)\n [#2746](https://github.com/rust-lang/mdBook/pull/2746)\n- Fixed several sidebar animation bugs, particularly when manually resizing.\n [#2750](https://github.com/rust-lang/mdBook/pull/2750)\n\n## mdBook 0.4.51\n[v0.4.50...v0.4.51](https://github.com/rust-lang/mdBook/compare/v0.4.50...v0.4.51)\n\n### Fixed\n- Fixed regression that broke the `S` search hotkey.\n [#2713](https://github.com/rust-lang/mdBook/pull/2713)\n\n## mdBook 0.4.50\n[v0.4.49...v0.4.50](https://github.com/rust-lang/mdBook/compare/v0.4.49...v0.4.50)\n\n### Added\n\n- Added a keyboard shortcut help popup when pressing `?`.\n [#2608](https://github.com/rust-lang/mdBook/pull/2608)\n\n### Changed\n\n- Changed the look of the sidebar resize handle to match the new rustdoc format.\n [#2691](https://github.com/rust-lang/mdBook/pull/2691)\n- `/` can now be used to open the search bar.\n [#2698](https://github.com/rust-lang/mdBook/pull/2698)\n- Pressing enter from the search bar will navigate to the first entry.\n [#2698](https://github.com/rust-lang/mdBook/pull/2698)\n- Updated `opener` to drop some dependencies.\n [#2709](https://github.com/rust-lang/mdBook/pull/2709)\n- Updated dependencies, MSRV raised to 1.82.\n [#2711](https://github.com/rust-lang/mdBook/pull/2711)\n\n### Fixed\n\n- Fixed uncaught exception when pressing down when there are no search results.\n [#2698](https://github.com/rust-lang/mdBook/pull/2698)\n- Fixed syntax highlighting of Rust code in the ACE editor.\n [#2710](https://github.com/rust-lang/mdBook/pull/2710)\n\n## mdBook 0.4.49\n[v0.4.48...v0.4.49](https://github.com/rust-lang/mdBook/compare/v0.4.48...v0.4.49)\n\n### Added\n\n- Added a warning on unused fields in the root of `book.toml`.\n [#2622](https://github.com/rust-lang/mdBook/pull/2622)\n\n### Changed\n\n- Updated dependencies.\n [#2650](https://github.com/rust-lang/mdBook/pull/2650)\n [#2688](https://github.com/rust-lang/mdBook/pull/2688)\n- Updated minimum Rust version to 1.81.\n [#2688](https://github.com/rust-lang/mdBook/pull/2688)\n- The unused `book.multilingual` field is no longer serialized, or shown in `mdbook init`.\n [#2689](https://github.com/rust-lang/mdBook/pull/2689)\n- Speed up search index loading by using `JSON.parse` instead of parsing JavaScript.\n [#2633](https://github.com/rust-lang/mdBook/pull/2633)\n\n### Fixed\n\n- Search highlighting will not try to highlight in SVG `` elements because it breaks the element.\n [#2668](https://github.com/rust-lang/mdBook/pull/2668)\n- Fixed scrolling of the sidebar when a search highlight term is in the URL.\n [#2675](https://github.com/rust-lang/mdBook/pull/2675)\n- Fixed issues when multiple footnote definitions use the same ID. Now, only one definition is used, and a warning is displayed.\n [#2681](https://github.com/rust-lang/mdBook/pull/2681)\n- The sidebar is now restricted to 80% of the viewport width to make it possible to collapse it when the viewport is very narrow.\n [#2679](https://github.com/rust-lang/mdBook/pull/2679)\n\n## mdBook 0.4.48\n[v0.4.47...v0.4.48](https://github.com/rust-lang/mdBook/compare/v0.4.47...v0.4.48)\n\n### Added\n\n- Footnotes now have back-reference links. These links bring the reader back to the original location. As part of this change, footnotes are now only rendered at the bottom of the page. This also includes some styling updates and fixes for footnote rendering.\n [#2626](https://github.com/rust-lang/mdBook/pull/2626)\n- Added an \"Auto\" theme selection option which will default to the system-preferred mode. This will also automatically switch when the system changes the preferred mode.\n [#2576](https://github.com/rust-lang/mdBook/pull/2576)\n\n### Changed\n\n- The `searchindex.json` file has been removed; only the `searchindex.js` file will be generated.\n [#2552](https://github.com/rust-lang/mdBook/pull/2552)\n- Updated Javascript code to use eslint.\n [#2554](https://github.com/rust-lang/mdBook/pull/2554)\n- An error is generated if there are duplicate files in `SUMMARY.md`.\n [#2613](https://github.com/rust-lang/mdBook/pull/2613)\n\n## mdBook 0.4.47\n[v0.4.46...v0.4.47](https://github.com/rust-lang/mdBook/compare/v0.4.46...v0.4.47)\n\n### Fixed\n\n- Fixed search not showing up in sub-directories.\n [#2586](https://github.com/rust-lang/mdBook/pull/2586)\n\n## mdBook 0.4.46\n[v0.4.45...v0.4.46](https://github.com/rust-lang/mdBook/compare/v0.4.45...v0.4.46)\n\n### Changed\n\n- The `output.html.hash-files` config option has been added to add hashes to static filenames to bust any caches when a book is updated. `{{resource}}` template tags have been added so that links can be properly generated to those files.\n [#1368](https://github.com/rust-lang/mdBook/pull/1368)\n\n### Fixed\n\n- Playground links for Rust 2024 now set the edition correctly.\n [#2557](https://github.com/rust-lang/mdBook/pull/2557)\n\n## mdBook 0.4.45\n[v0.4.44...v0.4.45](https://github.com/rust-lang/mdBook/compare/v0.4.44...v0.4.45)\n\n### Changed\n\n- Added context to error message when rustdoc is not found.\n [#2545](https://github.com/rust-lang/mdBook/pull/2545)\n- Slightly changed the styling rules around margins of footnotes.\n [#2524](https://github.com/rust-lang/mdBook/pull/2524)\n\n### Fixed\n\n- Fixed an issue where it would panic if a source_path is not set.\n [#2550](https://github.com/rust-lang/mdBook/pull/2550)\n\n## mdBook 0.4.44\n[v0.4.43...v0.4.44](https://github.com/rust-lang/mdBook/compare/v0.4.43...v0.4.44)\n\n### Added\n\n- Added pre-built aarch64-apple-darwin binaries to the releases.\n [#2500](https://github.com/rust-lang/mdBook/pull/2500)\n- `mdbook clean` now shows a summary of what it did.\n [#2458](https://github.com/rust-lang/mdBook/pull/2458)\n- Added the `output.html.search.chapter` config setting to disable search indexing of individual chapters.\n [#2533](https://github.com/rust-lang/mdBook/pull/2533)\n\n### Fixed\n\n- Fixed auto-scrolling the side-bar when loading a page with a `#` fragment URL.\n [#2517](https://github.com/rust-lang/mdBook/pull/2517)\n- Fixed display of sidebar when javascript is disabled.\n [#2529](https://github.com/rust-lang/mdBook/pull/2529)\n- Fixed the sidebar visibility getting out of sync with the button.\n [#2532](https://github.com/rust-lang/mdBook/pull/2532)\n\n### Changed\n\n- ❗ Rust code block hidden lines now follow the same logic as rustdoc. This requires a space after the `#` symbol.\n [#2530](https://github.com/rust-lang/mdBook/pull/2530)\n- ❗ Updated the Linux pre-built binaries which requires a newer version of glibc (2.34).\n [#2523](https://github.com/rust-lang/mdBook/pull/2523)\n- Updated dependencies\n [#2538](https://github.com/rust-lang/mdBook/pull/2538)\n [#2539](https://github.com/rust-lang/mdBook/pull/2539)\n\n## mdBook 0.4.43\n[v0.4.42...v0.4.43](https://github.com/rust-lang/mdBook/compare/v0.4.42...v0.4.43)\n\n### Fixed\n\n- Fixed setting the title in `mdbook init` when no git user is configured.\n [#2486](https://github.com/rust-lang/mdBook/pull/2486)\n\n### Changed\n\n- The Rust 2024 edition no longer needs `-Zunstable-options`.\n [#2495](https://github.com/rust-lang/mdBook/pull/2495)\n\n## mdBook 0.4.42\n[v0.4.41...v0.4.42](https://github.com/rust-lang/mdBook/compare/v0.4.41...v0.4.42)\n\n### Fixed\n\n- Fixed chapter list folding.\n [#2473](https://github.com/rust-lang/mdBook/pull/2473)\n\n## mdBook 0.4.41\n[v0.4.40...v0.4.41](https://github.com/rust-lang/mdBook/compare/v0.4.40...v0.4.41)\n\n**Note:** If you have a custom `index.hbs` theme file, you will need to update it to the latest version.\n\n### Added\n\n- Added preliminary support for Rust 2024 edition.\n [#2398](https://github.com/rust-lang/mdBook/pull/2398)\n- Added a full example of the remove-emphasis preprocessor.\n [#2464](https://github.com/rust-lang/mdBook/pull/2464)\n\n### Changed\n\n- Adjusted styling of clipboard/play icons.\n [#2421](https://github.com/rust-lang/mdBook/pull/2421)\n- Updated to handlebars v6.\n [#2416](https://github.com/rust-lang/mdBook/pull/2416)\n- Attr and section rules now have specific code highlighting.\n [#2448](https://github.com/rust-lang/mdBook/pull/2448)\n- The sidebar is now loaded from a common file, significantly reducing the book size when there are many chapters.\n [#2414](https://github.com/rust-lang/mdBook/pull/2414)\n- Updated dependencies.\n [#2470](https://github.com/rust-lang/mdBook/pull/2470)\n\n### Fixed\n\n- Improved theme support when JavaScript is disabled.\n [#2454](https://github.com/rust-lang/mdBook/pull/2454)\n- Fixed broken themes when localStorage has an invalid theme id.\n [#2463](https://github.com/rust-lang/mdBook/pull/2463)\n- Adjusted the line-height of superscripts (and footnotes) to avoid adding extra space between lines.\n [#2465](https://github.com/rust-lang/mdBook/pull/2465)\n\n## mdBook 0.4.40\n[v0.4.39...v0.4.40](https://github.com/rust-lang/mdBook/compare/v0.4.39...v0.4.40)\n\n### Fixed\n\n- Reverted the update to pulldown-cmark which broke the semver API.\n [#2388](https://github.com/rust-lang/mdBook/pull/2388)\n\n## mdBook 0.4.39\n[v0.4.38...v0.4.39](https://github.com/rust-lang/mdBook/compare/v0.4.38...v0.4.39)\n\n### Fixed\n\n- Fixed the automatic deploy broken in the previous release.\n [#2383](https://github.com/rust-lang/mdBook/pull/2383)\n\n## mdBook 0.4.38\n[v0.4.37...v0.4.38](https://github.com/rust-lang/mdBook/compare/v0.4.37...v0.4.38)\n\n### Added\n\n- Added `nix` to the default set of languages supported for syntax highlighting.\n [#2262](https://github.com/rust-lang/mdBook/pull/2262)\n\n### Changed\n\n- The `output.html.curly-quotes` option has been renamed to `output.html.smart-punctuation` to better reflect what it does. The old option `curly-quotes` is kept for compatibility, but may be removed in the future.\n [#2327](https://github.com/rust-lang/mdBook/pull/2327)\n- The file-watcher used in `mdbook serve` and `mdbook watch` now uses a poll-based watcher instead of the native operating system notifications. This should fix issues on various systems and environments, and more accurately detect when files change. The native watcher can still be used with the `--watcher native` CLI option.\n [#2325](https://github.com/rust-lang/mdBook/pull/2325)\n- `mdbook test` output now includes color, and shows relative paths to the source.\n [#2259](https://github.com/rust-lang/mdBook/pull/2259)\n- Updated dependencies, MSRV raised to 1.74\n [#2350](https://github.com/rust-lang/mdBook/pull/2350)\n [#2351](https://github.com/rust-lang/mdBook/pull/2351)\n [#2378](https://github.com/rust-lang/mdBook/pull/2378)\n [#2381](https://github.com/rust-lang/mdBook/pull/2381)\n\n### Fixed\n\n- Reduced memory allocation when copying files.\n [#2355](https://github.com/rust-lang/mdBook/pull/2355)\n- Fixed the horizontal divider in `SUMMARY.md` from being indented into the previous nested section.\n [#2364](https://github.com/rust-lang/mdBook/pull/2364)\n- Removed unnecessary `@import` in the CSS.\n [#2260](https://github.com/rust-lang/mdBook/pull/2260)\n\n## mdBook 0.4.37\n[v0.4.36...v0.4.37](https://github.com/rust-lang/mdBook/compare/v0.4.36...v0.4.37)\n\n### Changed\n- ❗️ Updated the markdown parser. This brings in many changes to more closely follow the CommonMark spec. This may cause some small rendering changes. It is recommended to compare the output of the old and new version to check for changes. See for more information.\n [#2308](https://github.com/rust-lang/mdBook/pull/2308)\n- The warning about the legacy `src/theme` directory has been removed.\n [#2263](https://github.com/rust-lang/mdBook/pull/2263)\n- Updated dependencies. MSRV raised to 1.71.0.\n [#2283](https://github.com/rust-lang/mdBook/pull/2283)\n [#2293](https://github.com/rust-lang/mdBook/pull/2293)\n [#2297](https://github.com/rust-lang/mdBook/pull/2297)\n [#2310](https://github.com/rust-lang/mdBook/pull/2310)\n [#2309](https://github.com/rust-lang/mdBook/pull/2309)\n- Some internal performance/memory improvements.\n [#2273](https://github.com/rust-lang/mdBook/pull/2273)\n [#2290](https://github.com/rust-lang/mdBook/pull/2290)\n- Made the `pathdiff` dependency optional based on the `watch` feature.\n [#2291](https://github.com/rust-lang/mdBook/pull/2291)\n\n### Fixed\n- The `s` shortcut key handler should not trigger when focus is in an HTML form.\n [#2311](https://github.com/rust-lang/mdBook/pull/2311)\n\n## mdBook 0.4.36\n[v0.4.35...v0.4.36](https://github.com/rust-lang/mdBook/compare/v0.4.35...v0.4.36)\n\n### Added\n- Added Nim to the default highlighted languages.\n [#2232](https://github.com/rust-lang/mdBook/pull/2232)\n- Added a small indicator for the sidebar resize handle.\n [#2209](https://github.com/rust-lang/mdBook/pull/2209)\n\n### Changed\n- Updated dependencies. MSRV raised to 1.70.0.\n [#2173](https://github.com/rust-lang/mdBook/pull/2173)\n [#2250](https://github.com/rust-lang/mdBook/pull/2250)\n [#2252](https://github.com/rust-lang/mdBook/pull/2252)\n\n### Fixed\n- Fixed blank column in print page when the sidebar was visible.\n [#2235](https://github.com/rust-lang/mdBook/pull/2235)\n- Fixed indentation of code blocks when Javascript is disabled.\n [#2162](https://github.com/rust-lang/mdBook/pull/2162)\n- Fixed a panic when `mdbook serve` or `mdbook watch` were given certain kinds of paths.\n [#2229](https://github.com/rust-lang/mdBook/pull/2229)\n\n## mdBook 0.4.35\n[v0.4.34...v0.4.35](https://github.com/rust-lang/mdBook/compare/v0.4.34...v0.4.35)\n\n### Added\n- Added the `book.text-direction` setting for explicit support for right-to-left languages.\n [#1641](https://github.com/rust-lang/mdBook/pull/1641)\n- Added `rel=prefetch` to the \"next\" links to potentially improve browser performance.\n [#2168](https://github.com/rust-lang/mdBook/pull/2168)\n- Added a `.warning` CSS class which is styled for displaying warning blocks.\n [#2187](https://github.com/rust-lang/mdBook/pull/2187)\n\n### Changed\n- Better support of the sidebar when JavaScript is disabled.\n [#2175](https://github.com/rust-lang/mdBook/pull/2175)\n\n## mdBook 0.4.34\n[v0.4.33...v0.4.34](https://github.com/rust-lang/mdBook/compare/v0.4.33...v0.4.34)\n\n### Fixed\n- Fixed file change watcher failing on macOS with a large number of files.\n [#2157](https://github.com/rust-lang/mdBook/pull/2157)\n\n## mdBook 0.4.33\n[v0.4.32...v0.4.33](https://github.com/rust-lang/mdBook/compare/v0.4.32...v0.4.33)\n\n### Added\n- The `color-scheme` CSS property is now set based on the light/dark theme, which applies some slight color differences in browser elements like scroll bars on some browsers.\n [#2134](https://github.com/rust-lang/mdBook/pull/2134)\n\n### Fixed\n- Fixed watching of extra-watch-dirs when not running in the book root directory.\n [#2146](https://github.com/rust-lang/mdBook/pull/2146)\n- Reverted the dependency update to the `toml` crate (again!). This was an unintentional breaking change in 0.4.32.\n [#2021](https://github.com/rust-lang/mdBook/pull/2021)\n- Changed macOS change notifications to use the kqueue implementation which should fix some issues with repeated rebuilds when a file changed.\n [#2152](https://github.com/rust-lang/mdBook/pull/2152)\n- Don't set a background color in the print page for code blocks in a header.\n [#2150](https://github.com/rust-lang/mdBook/pull/2150)\n\n## mdBook 0.4.32\n[v0.4.31...v0.4.32](https://github.com/rust-lang/mdBook/compare/v0.4.31...v0.4.32)\n\n### Fixed\n- Fixed theme-color meta tag not syncing with the theme.\n [#2118](https://github.com/rust-lang/mdBook/pull/2118)\n\n### Changed\n- Updated all dependencies.\n [#2121](https://github.com/rust-lang/mdBook/pull/2121)\n [#2122](https://github.com/rust-lang/mdBook/pull/2122)\n [#2123](https://github.com/rust-lang/mdBook/pull/2123)\n [#2124](https://github.com/rust-lang/mdBook/pull/2124)\n [#2125](https://github.com/rust-lang/mdBook/pull/2125)\n [#2126](https://github.com/rust-lang/mdBook/pull/2126)\n\n## mdBook 0.4.31\n[v0.4.30...v0.4.31](https://github.com/rust-lang/mdBook/compare/v0.4.30...v0.4.31)\n\n### Fixed\n- Fixed menu border render flash during page navigation.\n [#2101](https://github.com/rust-lang/mdBook/pull/2101)\n- Fixed flicker setting sidebar scroll position.\n [#2104](https://github.com/rust-lang/mdBook/pull/2104)\n- Fixed compile error with proc-macro2 on latest Rust nightly.\n [#2109](https://github.com/rust-lang/mdBook/pull/2109)\n\n## mdBook 0.4.30\n[v0.4.29...v0.4.30](https://github.com/rust-lang/mdBook/compare/v0.4.29...v0.4.30)\n\n### Added\n- Added support for heading attributes.\n Attributes are specified in curly braces just after the heading text.\n An HTML ID can be specified with `#` and classes with `.`.\n For example: `## My heading {#custom-id .class1 .class2}`\n [#2013](https://github.com/rust-lang/mdBook/pull/2013)\n- Added support for hidden code lines for languages other than Rust.\n The `output.html.code.hidelines` table allows you to define the prefix character that will be used to hide code lines based on the language.\n [#2093](https://github.com/rust-lang/mdBook/pull/2093)\n\n### Fixed\n- Fixed a few minor markdown rendering issues.\n [#2092](https://github.com/rust-lang/mdBook/pull/2092)\n\n## mdBook 0.4.29\n[v0.4.28...v0.4.29](https://github.com/rust-lang/mdBook/compare/v0.4.28...v0.4.29)\n\n### Changed\n- Built-in fonts are no longer copied when `fonts/fonts.css` is overridden in the theme directory.\n Additionally, the warning about `copy-fonts` has been removed if `fonts/fonts.css` is specified.\n [#2080](https://github.com/rust-lang/mdBook/pull/2080)\n- `mdbook init --force` now skips all interactive prompts as intended.\n [#2057](https://github.com/rust-lang/mdBook/pull/2057)\n- Updated dependencies\n [#2063](https://github.com/rust-lang/mdBook/pull/2063)\n [#2086](https://github.com/rust-lang/mdBook/pull/2086)\n [#2082](https://github.com/rust-lang/mdBook/pull/2082)\n [#2084](https://github.com/rust-lang/mdBook/pull/2084)\n [#2085](https://github.com/rust-lang/mdBook/pull/2085)\n\n### Fixed\n- Switched from the `gitignore` library to `ignore`. This should bring some improvements with gitignore handling.\n [#2076](https://github.com/rust-lang/mdBook/pull/2076)\n\n## mdBook 0.4.28\n[v0.4.27...v0.4.28](https://github.com/rust-lang/mdBook/compare/v0.4.27...v0.4.28)\n\n### Changed\n- The sidebar is now shown on wide screens when localstorage is disabled.\n [#2017](https://github.com/rust-lang/mdBook/pull/2017)\n- Preprocessors are now run with `mdbook test`.\n [#1986](https://github.com/rust-lang/mdBook/pull/1986)\n\n### Fixed\n- Fixed regression in 0.4.26 that prevented the title bar from scrolling properly on smaller screens.\n [#2039](https://github.com/rust-lang/mdBook/pull/2039)\n\n## mdBook 0.4.27\n[v0.4.26...v0.4.27](https://github.com/rust-lang/mdBook/compare/v0.4.26...v0.4.27)\n\n### Changed\n- Reverted the dependency update to the `toml` crate. This was an unintentional breaking change in 0.4.26.\n [#2021](https://github.com/rust-lang/mdBook/pull/2021)\n\n## mdBook 0.4.26\n[v0.4.25...v0.4.26](https://github.com/rust-lang/mdBook/compare/v0.4.25...v0.4.26)\n\n**The 0.4.26 release has been yanked due to an unintentional breaking change.**\n\n### Changed\n- Removed custom scrollbars for webkit browsers\n [#1961](https://github.com/rust-lang/mdBook/pull/1961)\n- Updated some dependencies\n [#1998](https://github.com/rust-lang/mdBook/pull/1998)\n [#2009](https://github.com/rust-lang/mdBook/pull/2009)\n [#2011](https://github.com/rust-lang/mdBook/pull/2011)\n- Fonts are now part of the theme.\n The `output.html.copy-fonts` option has been deprecated.\n To define custom fonts, be sure to define `theme/fonts.css`.\n [#1987](https://github.com/rust-lang/mdBook/pull/1987)\n\n### Fixed\n- Fixed overflow viewport issue with mobile Safari\n [#1994](https://github.com/rust-lang/mdBook/pull/1994)\n\n## mdBook 0.4.25\n[e14d381...1ba74a3](https://github.com/rust-lang/mdBook/compare/e14d381...1ba74a3)\n\n### Fixed\n- Fixed a regression where `mdbook test -L deps path-to-book` would not work.\n [#1959](https://github.com/rust-lang/mdBook/pull/1959)\n\n## mdBook 0.4.24\n[eb77083...8767ebf](https://github.com/rust-lang/mdBook/compare/eb77083...8767ebf)\n\n### Fixed\n- The precompiled linux-gnu mdbook binary available on [GitHub Releases](https://github.com/rust-lang/mdBook/releases) inadvertently switched to a newer version of glibc. This release goes back to an older version that should be more compatible on older versions of Linux.\n [#1955](https://github.com/rust-lang/mdBook/pull/1955)\n\n## mdBook 0.4.23\n[678b469...68a75da](https://github.com/rust-lang/mdBook/compare/678b469...68a75da)\n\n### Changed\n- Updated all dependencies\n [#1951](https://github.com/rust-lang/mdBook/pull/1951)\n [#1952](https://github.com/rust-lang/mdBook/pull/1952)\n [#1844](https://github.com/rust-lang/mdBook/pull/1844)\n- Updated minimum Rust version to 1.60.\n [#1951](https://github.com/rust-lang/mdBook/pull/1951)\n\n### Fixed\n- Fixed a regression where playground code was missing hidden lines, preventing it from compiling correctly.\n [#1950](https://github.com/rust-lang/mdBook/pull/1950)\n\n## mdBook 0.4.22\n[40c06f5...4844f72](https://github.com/rust-lang/mdBook/compare/40c06f5...4844f72)\n\n### Added\n- Added a `--chapter` option to `mdbook test` to specify a specific chapter to test.\n [#1741](https://github.com/rust-lang/mdBook/pull/1741)\n- Added CSS styling for `` tags.\n [#1906](https://github.com/rust-lang/mdBook/pull/1906)\n- Added pre-compiled binaries for `x86_64-unknown-linux-musl` and `aarch64-unknown-linux-musl` (see [Releases](https://github.com/rust-lang/mdBook/releases)).\n [#1862](https://github.com/rust-lang/mdBook/pull/1862)\n- Added `build.extra-watch-dirs` which is an array of additional directories to watch for changes when running `mdbook serve`.\n [#1884](https://github.com/rust-lang/mdBook/pull/1884)\n\n### Changed\n- Removed the `type=\"text/javascript\"` attribute from `\n {{/if}}\n\n \n \n \n \n \n \n
\n
\n

Keyboard shortcuts

\n
\n

Press ← or → to navigate between chapters

\n {{#if search_enabled}}\n

Press S or / to search in the book

\n {{/if}}\n

Press ? to show this help

\n

Press Esc to hide this help

\n
\n
\n
\n
\n \n \n\n \n \n\n \n\n \n \n\n \n\n
\n\n
\n {{> header}}\n
\n
\n
\n \n \n
    \n
    • \n
    • \n
    • \n
    • \n
    • \n
    • \n
\n {{#if search_enabled}}\n \n {{/if}}\n
\n\n

{{ book_title }}

\n\n
\n {{#if print_enable}}\n \n {{fa \"solid\" \"print\" \"print-button\"}}\n \n {{/if}}\n {{#if git_repository_url}}\n \n {{fa git_repository_icon_class git_repository_icon}}\n \n {{/if}}\n {{#if git_repository_edit_url}}\n \n {{fa \"solid\" \"pencil\" \"git-edit-button\"}}\n \n {{/if}}\n\n
\n
\n\n {{#if search_enabled}}\n
\n
\n
\n \n \n
\n
\n
\n
\n
    \n
\n
\n
\n {{/if}}\n\n \n \n\n \n
\n\n \n\n
\n\n \n \n \n \n \n\n {{#if live_reload_endpoint}}\n \n \n {{/if}}\n\n {{#if playground_line_numbers}}\n \n {{/if}}\n\n {{#if playground_copyable}}\n \n {{/if}}\n\n {{#if playground_js}}\n \n \n \n \n \n {{/if}}\n\n {{#if search_js}}\n \n \n \n {{/if}}\n\n \n \n \n\n \n {{#each additional_js}}\n \n {{/each}}\n\n {{#if is_print}}\n {{#if mathjax_support}}\n \n {{else}}\n \n {{/if}}\n {{/if}}\n\n {{#if fragment_map}}\n \n {{/if}}\n\n
\n \n\n" }, { "path": "crates/mdbook-html/front-end/templates/redirect.hbs", "content": "\n\n \n \n Redirecting...\n \n \n \n \n

Redirecting to... {{url}}.

\n\n\n \n\n" }, { "path": "crates/mdbook-html/front-end/templates/toc.html.hbs", "content": "\n\n \n \n \n \n {{#if base_url}}\n \n {{/if}}\n \n {{> head}}\n \n \n \n \n \n {{#if print_enable}}\n \n {{/if}}\n \n \n \n {{#each additional_css}}\n \n {{/each}}\n \n \n {{#toc}}{{/toc}}\n \n\n" }, { "path": "crates/mdbook-html/front-end/templates/toc.js.hbs", "content": "// Populate the sidebar\n//\n// This is a script, and not included directly in the page, to control the total size of the book.\n// The TOC contains an entry for each page, so if each page includes a copy of the TOC,\n// the total size of the page becomes O(n**2).\nclass MDBookSidebarScrollbox extends HTMLElement {\n constructor() {\n super();\n }\n connectedCallback() {\n this.innerHTML = '{{#toc}}{{/toc}}';\n // Set the current, active page, and reveal it if it's hidden\n let current_page = document.location.href.toString().split('#')[0].split('?')[0];\n if (current_page.endsWith('/')) {\n current_page += 'index.html';\n }\n const links = Array.prototype.slice.call(this.querySelectorAll('a'));\n const l = links.length;\n for (let i = 0; i < l; ++i) {\n const link = links[i];\n const href = link.getAttribute('href');\n if (href && !href.startsWith('#') && !/^(?:[a-z+]+:)?\\/\\//.test(href)) {\n link.href = path_to_root + href;\n }\n // The 'index' page is supposed to alias the first chapter in the book.\n if (link.href === current_page\n || i === 0\n && path_to_root === ''\n && current_page.endsWith('/index.html')) {\n link.classList.add('active');\n let parent = link.parentElement;\n while (parent) {\n if (parent.tagName === 'LI' && parent.classList.contains('chapter-item')) {\n parent.classList.add('expanded');\n }\n parent = parent.parentElement;\n }\n }\n }\n // Track and set sidebar scroll position\n this.addEventListener('click', e => {\n if (e.target.tagName === 'A') {\n const clientRect = e.target.getBoundingClientRect();\n const sidebarRect = this.getBoundingClientRect();\n sessionStorage.setItem('sidebar-scroll-offset', clientRect.top - sidebarRect.top);\n }\n }, { passive: true });\n const sidebarScrollOffset = sessionStorage.getItem('sidebar-scroll-offset');\n sessionStorage.removeItem('sidebar-scroll-offset');\n if (sidebarScrollOffset !== null) {\n // preserve sidebar scroll position when navigating via links within sidebar\n const activeSection = this.querySelector('.active');\n if (activeSection) {\n const clientRect = activeSection.getBoundingClientRect();\n const sidebarRect = this.getBoundingClientRect();\n const currentOffset = clientRect.top - sidebarRect.top;\n this.scrollTop += currentOffset - parseFloat(sidebarScrollOffset);\n }\n } else {\n // scroll sidebar to current active section when navigating via\n // 'next/previous chapter' buttons\n const activeSection = document.querySelector('#mdbook-sidebar .active');\n if (activeSection) {\n activeSection.scrollIntoView({ block: 'center' });\n }\n }\n // Toggle buttons\n const sidebarAnchorToggles = document.querySelectorAll('.chapter-fold-toggle');\n function toggleSection(ev) {\n ev.currentTarget.parentElement.parentElement.classList.toggle('expanded');\n }\n Array.from(sidebarAnchorToggles).forEach(el => {\n el.addEventListener('click', toggleSection);\n });\n }\n}\nwindow.customElements.define('mdbook-sidebar-scrollbox', MDBookSidebarScrollbox);\n\n{{#if sidebar_header_nav}}\n\n// ---------------------------------------------------------------------------\n// Support for dynamically adding headers to the sidebar.\n\n(function() {\n // This is used to detect which direction the page has scrolled since the\n // last scroll event.\n let lastKnownScrollPosition = 0;\n // This is the threshold in px from the top of the screen where it will\n // consider a header the \"current\" header when scrolling down.\n const defaultDownThreshold = 150;\n // Same as defaultDownThreshold, except when scrolling up.\n const defaultUpThreshold = 300;\n // The threshold is a virtual horizontal line on the screen where it\n // considers the \"current\" header to be above the line. The threshold is\n // modified dynamically to handle headers that are near the bottom of the\n // screen, and to slightly offset the behavior when scrolling up vs down.\n let threshold = defaultDownThreshold;\n // This is used to disable updates while scrolling. This is needed when\n // clicking the header in the sidebar, which triggers a scroll event. It\n // is somewhat finicky to detect when the scroll has finished, so this\n // uses a relatively dumb system of disabling scroll updates for a short\n // time after the click.\n let disableScroll = false;\n // Array of header elements on the page.\n let headers;\n // Array of li elements that are initially collapsed headers in the sidebar.\n // I'm not sure why eslint seems to have a false positive here.\n // eslint-disable-next-line prefer-const\n let headerToggles = [];\n // This is a debugging tool for the threshold which you can enable in the console.\n let thresholdDebug = false;\n\n // Updates the threshold based on the scroll position.\n function updateThreshold() {\n const scrollTop = window.pageYOffset || document.documentElement.scrollTop;\n const windowHeight = window.innerHeight;\n const documentHeight = document.documentElement.scrollHeight;\n\n // The number of pixels below the viewport, at most documentHeight.\n // This is used to push the threshold down to the bottom of the page\n // as the user scrolls towards the bottom.\n const pixelsBelow = Math.max(0, documentHeight - (scrollTop + windowHeight));\n // The number of pixels above the viewport, at least defaultDownThreshold.\n // Similar to pixelsBelow, this is used to push the threshold back towards\n // the top when reaching the top of the page.\n const pixelsAbove = Math.max(0, defaultDownThreshold - scrollTop);\n // How much the threshold should be offset once it gets close to the\n // bottom of the page.\n const bottomAdd = Math.max(0, windowHeight - pixelsBelow - defaultDownThreshold);\n let adjustedBottomAdd = bottomAdd;\n\n // Adjusts bottomAdd for a small document. The calculation above\n // assumes the document is at least twice the windowheight in size. If\n // it is less than that, then bottomAdd needs to be shrunk\n // proportional to the difference in size.\n if (documentHeight < windowHeight * 2) {\n const maxPixelsBelow = documentHeight - windowHeight;\n const t = 1 - pixelsBelow / Math.max(1, maxPixelsBelow);\n const clamp = Math.max(0, Math.min(1, t));\n adjustedBottomAdd *= clamp;\n }\n\n let scrollingDown = true;\n if (scrollTop < lastKnownScrollPosition) {\n scrollingDown = false;\n }\n\n if (scrollingDown) {\n // When scrolling down, move the threshold up towards the default\n // downwards threshold position. If near the bottom of the page,\n // adjustedBottomAdd will offset the threshold towards the bottom\n // of the page.\n const amountScrolledDown = scrollTop - lastKnownScrollPosition;\n const adjustedDefault = defaultDownThreshold + adjustedBottomAdd;\n threshold = Math.max(adjustedDefault, threshold - amountScrolledDown);\n } else {\n // When scrolling up, move the threshold down towards the default\n // upwards threshold position. If near the bottom of the page,\n // quickly transition the threshold back up where it normally\n // belongs.\n const amountScrolledUp = lastKnownScrollPosition - scrollTop;\n const adjustedDefault = defaultUpThreshold - pixelsAbove\n + Math.max(0, adjustedBottomAdd - defaultDownThreshold);\n threshold = Math.min(adjustedDefault, threshold + amountScrolledUp);\n }\n\n if (documentHeight <= windowHeight) {\n threshold = 0;\n }\n\n if (thresholdDebug) {\n const id = 'mdbook-threshold-debug-data';\n let data = document.getElementById(id);\n if (data === null) {\n data = document.createElement('div');\n data.id = id;\n data.style.cssText = `\n position: fixed;\n top: 50px;\n right: 10px;\n background-color: 0xeeeeee;\n z-index: 9999;\n pointer-events: none;\n `;\n document.body.appendChild(data);\n }\n data.innerHTML = `\n \n \n \n \n \n \n \n \n \n \n
documentHeight${documentHeight.toFixed(1)}
windowHeight${windowHeight.toFixed(1)}
scrollTop${scrollTop.toFixed(1)}
pixelsAbove${pixelsAbove.toFixed(1)}
pixelsBelow${pixelsBelow.toFixed(1)}
bottomAdd${bottomAdd.toFixed(1)}
adjustedBottomAdd${adjustedBottomAdd.toFixed(1)}
scrollingDown${scrollingDown}
threshold${threshold.toFixed(1)}
\n `;\n drawDebugLine();\n }\n\n lastKnownScrollPosition = scrollTop;\n }\n\n function drawDebugLine() {\n if (!document.body) {\n return;\n }\n const id = 'mdbook-threshold-debug-line';\n const existingLine = document.getElementById(id);\n if (existingLine) {\n existingLine.remove();\n }\n const line = document.createElement('div');\n line.id = id;\n line.style.cssText = `\n position: fixed;\n top: ${threshold}px;\n left: 0;\n width: 100vw;\n height: 2px;\n background-color: red;\n z-index: 9999;\n pointer-events: none;\n `;\n document.body.appendChild(line);\n }\n\n function mdbookEnableThresholdDebug() {\n thresholdDebug = true;\n updateThreshold();\n drawDebugLine();\n }\n\n window.mdbookEnableThresholdDebug = mdbookEnableThresholdDebug;\n\n // Updates which headers in the sidebar should be expanded. If the current\n // header is inside a collapsed group, then it, and all its parents should\n // be expanded.\n function updateHeaderExpanded(currentA) {\n // Add expanded to all header-item li ancestors.\n let current = currentA.parentElement;\n while (current) {\n if (current.tagName === 'LI' && current.classList.contains('header-item')) {\n current.classList.add('expanded');\n }\n current = current.parentElement;\n }\n }\n\n // Updates which header is marked as the \"current\" header in the sidebar.\n // This is done with a virtual Y threshold, where headers at or below\n // that line will be considered the current one.\n function updateCurrentHeader() {\n if (!headers || !headers.length) {\n return;\n }\n\n // Reset the classes, which will be rebuilt below.\n const els = document.getElementsByClassName('current-header');\n for (const el of els) {\n el.classList.remove('current-header');\n }\n for (const toggle of headerToggles) {\n toggle.classList.remove('expanded');\n }\n\n // Find the last header that is above the threshold.\n let lastHeader = null;\n for (const header of headers) {\n const rect = header.getBoundingClientRect();\n if (rect.top <= threshold) {\n lastHeader = header;\n } else {\n break;\n }\n }\n if (lastHeader === null) {\n lastHeader = headers[0];\n const rect = lastHeader.getBoundingClientRect();\n const windowHeight = window.innerHeight;\n if (rect.top >= windowHeight) {\n return;\n }\n }\n\n // Get the anchor in the summary.\n const href = '#' + lastHeader.id;\n const a = [...document.querySelectorAll('.header-in-summary')]\n .find(element => element.getAttribute('href') === href);\n if (!a) {\n return;\n }\n\n a.classList.add('current-header');\n\n updateHeaderExpanded(a);\n }\n\n // Updates which header is \"current\" based on the threshold line.\n function reloadCurrentHeader() {\n if (disableScroll) {\n return;\n }\n updateThreshold();\n updateCurrentHeader();\n }\n\n\n // When clicking on a header in the sidebar, this adjusts the threshold so\n // that it is located next to the header. This is so that header becomes\n // \"current\".\n function headerThresholdClick(event) {\n // See disableScroll description why this is done.\n disableScroll = true;\n setTimeout(() => {\n disableScroll = false;\n }, 100);\n // requestAnimationFrame is used to delay the update of the \"current\"\n // header until after the scroll is done, and the header is in the new\n // position.\n requestAnimationFrame(() => {\n requestAnimationFrame(() => {\n // Closest is needed because if it has child elements like .\n const a = event.target.closest('a');\n const href = a.getAttribute('href');\n const targetId = href.substring(1);\n const targetElement = document.getElementById(targetId);\n if (targetElement) {\n threshold = targetElement.getBoundingClientRect().bottom;\n updateCurrentHeader();\n }\n });\n });\n }\n\n // Takes the nodes from the given head and copies them over to the\n // destination, along with some filtering.\n function filterHeader(source, dest) {\n const clone = source.cloneNode(true);\n clone.querySelectorAll('mark').forEach(mark => {\n mark.replaceWith(...mark.childNodes);\n });\n dest.append(...clone.childNodes);\n }\n\n // Scans page for headers and adds them to the sidebar.\n document.addEventListener('DOMContentLoaded', function() {\n const activeSection = document.querySelector('#mdbook-sidebar .active');\n if (activeSection === null) {\n return;\n }\n\n const main = document.getElementsByTagName('main')[0];\n headers = Array.from(main.querySelectorAll('h2, h3, h4, h5, h6'))\n .filter(h => h.id !== '' && h.children.length && h.children[0].tagName === 'A');\n\n if (headers.length === 0) {\n return;\n }\n\n // Build a tree of headers in the sidebar.\n\n const stack = [];\n\n const firstLevel = parseInt(headers[0].tagName.charAt(1));\n for (let i = 1; i < firstLevel; i++) {\n const ol = document.createElement('ol');\n ol.classList.add('section');\n if (stack.length > 0) {\n stack[stack.length - 1].ol.appendChild(ol);\n }\n stack.push({level: i + 1, ol: ol});\n }\n\n // The level where it will start folding deeply nested headers.\n const foldLevel = 3;\n\n for (let i = 0; i < headers.length; i++) {\n const header = headers[i];\n const level = parseInt(header.tagName.charAt(1));\n\n const currentLevel = stack[stack.length - 1].level;\n if (level > currentLevel) {\n // Begin nesting to this level.\n for (let nextLevel = currentLevel + 1; nextLevel <= level; nextLevel++) {\n const ol = document.createElement('ol');\n ol.classList.add('section');\n const last = stack[stack.length - 1];\n const lastChild = last.ol.lastChild;\n // Handle the case where jumping more than one nesting\n // level, which doesn't have a list item to place this new\n // list inside of.\n if (lastChild) {\n lastChild.appendChild(ol);\n } else {\n last.ol.appendChild(ol);\n }\n stack.push({level: nextLevel, ol: ol});\n }\n } else if (level < currentLevel) {\n while (stack.length > 1 && stack[stack.length - 1].level > level) {\n stack.pop();\n }\n }\n\n const li = document.createElement('li');\n li.classList.add('header-item');\n li.classList.add('expanded');\n if (level < foldLevel) {\n li.classList.add('expanded');\n }\n const span = document.createElement('span');\n span.classList.add('chapter-link-wrapper');\n const a = document.createElement('a');\n span.appendChild(a);\n a.href = '#' + header.id;\n a.classList.add('header-in-summary');\n filterHeader(header.children[0], a);\n a.addEventListener('click', headerThresholdClick);\n const nextHeader = headers[i + 1];\n if (nextHeader !== undefined) {\n const nextLevel = parseInt(nextHeader.tagName.charAt(1));\n if (nextLevel > level && level >= foldLevel) {\n const toggle = document.createElement('a');\n toggle.classList.add('chapter-fold-toggle');\n toggle.classList.add('header-toggle');\n toggle.addEventListener('click', () => {\n li.classList.toggle('expanded');\n });\n const toggleDiv = document.createElement('div');\n toggleDiv.textContent = '❱';\n toggle.appendChild(toggleDiv);\n span.appendChild(toggle);\n headerToggles.push(li);\n }\n }\n li.appendChild(span);\n\n const currentParent = stack[stack.length - 1];\n currentParent.ol.appendChild(li);\n }\n\n const onThisPage = document.createElement('div');\n onThisPage.classList.add('on-this-page');\n onThisPage.append(stack[0].ol);\n const activeItemSpan = activeSection.parentElement;\n activeItemSpan.after(onThisPage);\n });\n\n document.addEventListener('DOMContentLoaded', reloadCurrentHeader);\n document.addEventListener('scroll', reloadCurrentHeader, { passive: true });\n})();\n\n{{/if}}\n" }, { "path": "crates/mdbook-html/src/html/admonitions.rs", "content": "use pulldown_cmark::BlockQuoteKind;\n\n// This icon is from GitHub, MIT License, see https://github.com/primer/octicons\nconst ICON_NOTE: &str = r#\"\"#;\n\n// This icon is from GitHub, MIT License, see https://github.com/primer/octicons\nconst ICON_TIP: &str = r#\"\"#;\n\n// This icon is from GitHub, MIT License, see https://github.com/primer/octicons\nconst ICON_IMPORTANT: &str = r#\"\"#;\n\n// This icon is from GitHub, MIT License, see https://github.com/primer/octicons\nconst ICON_WARNING: &str = r#\"\"#;\n\n// This icon is from GitHub, MIT License, see https://github.com/primer/octicons\nconst ICON_CAUTION: &str = r#\"\"#;\n\npub(crate) fn select_tag(kind: BlockQuoteKind) -> (&'static str, &'static str, &'static str) {\n match kind {\n BlockQuoteKind::Note => (\"note\", ICON_NOTE, \"Note\"),\n BlockQuoteKind::Tip => (\"tip\", ICON_TIP, \"Tip\"),\n BlockQuoteKind::Important => (\"important\", ICON_IMPORTANT, \"Important\"),\n BlockQuoteKind::Warning => (\"warning\", ICON_WARNING, \"Warning\"),\n BlockQuoteKind::Caution => (\"caution\", ICON_CAUTION, \"Caution\"),\n }\n}\n" }, { "path": "crates/mdbook-html/src/html/hide_lines.rs", "content": "//! Support for hiding code lines.\n\nuse crate::html::{Element, Node};\nuse ego_tree::{NodeId, Tree};\nuse html5ever::tendril::StrTendril;\nuse mdbook_core::static_regex;\nuse std::collections::HashMap;\n\n/// Wraps hidden lines in a `` for the given code block.\npub(crate) fn hide_lines(\n tree: &mut Tree,\n code_id: NodeId,\n hidelines: &HashMap,\n) {\n let mut node = tree.get_mut(code_id).unwrap();\n let el = node.value().as_element().unwrap();\n\n let classes: Vec<_> = el.attr(\"class\").unwrap_or_default().split(' ').collect();\n let language = classes\n .iter()\n .filter_map(|cls| cls.strip_prefix(\"language-\"))\n .next()\n .unwrap_or_default()\n .to_string();\n let hideline_info = classes\n .iter()\n .filter_map(|cls| cls.strip_prefix(\"hidelines=\"))\n .map(|prefix| prefix.to_string())\n .next();\n\n if let Some(mut child) = node.first_child()\n && let Node::Text(text) = child.value()\n {\n if language == \"rust\" {\n let new_nodes = hide_lines_rust(text);\n child.detach();\n let root = tree.extend_tree(new_nodes);\n let root_id = root.id();\n let mut node = tree.get_mut(code_id).unwrap();\n node.reparent_from_id_append(root_id);\n } else {\n // Use the prefix from the code block, else the prefix from config.\n let hidelines_prefix = hideline_info\n .as_deref()\n .or_else(|| hidelines.get(&language).map(|p| p.as_str()));\n if let Some(prefix) = hidelines_prefix {\n let new_nodes = hide_lines_with_prefix(text, prefix);\n child.detach();\n let root = tree.extend_tree(new_nodes);\n let root_id = root.id();\n let mut node = tree.get_mut(code_id).unwrap();\n node.reparent_from_id_append(root_id);\n }\n }\n }\n}\n\n/// Wraps hidden lines in a `` specifically for Rust code blocks.\nfn hide_lines_rust(text: &StrTendril) -> Tree {\n static_regex!(BORING_LINES_REGEX, r\"^(\\s*)#(.?)(.*)$\");\n\n let mut tree = Tree::new(Node::Fragment);\n let mut root = tree.root_mut();\n let mut lines = text.lines().peekable();\n while let Some(line) = lines.next() {\n // Don't include newline on the last line.\n let newline = if lines.peek().is_none() { \"\" } else { \"\\n\" };\n if let Some(caps) = BORING_LINES_REGEX.captures(line) {\n if &caps[2] == \"#\" {\n root.append(Node::Text(\n format!(\"{}{}{}{newline}\", &caps[1], &caps[2], &caps[3]).into(),\n ));\n continue;\n } else if matches!(&caps[2], \"\" | \" \") {\n let mut span = Element::new(\"span\");\n span.insert_attr(\"class\", \"boring\".into());\n let mut span = root.append(Node::Element(span));\n span.append(Node::Text(\n format!(\"{}{}{newline}\", &caps[1], &caps[3]).into(),\n ));\n continue;\n }\n }\n root.append(Node::Text(format!(\"{line}{newline}\").into()));\n }\n tree\n}\n\n/// Wraps hidden lines in a `` tag for lines starting with the given prefix.\nfn hide_lines_with_prefix(content: &str, prefix: &str) -> Tree {\n let mut tree = Tree::new(Node::Fragment);\n let mut root = tree.root_mut();\n for line in content.lines() {\n if line.trim_start().starts_with(prefix) {\n let pos = line.find(prefix).unwrap();\n let (ws, rest) = (&line[..pos], &line[pos + prefix.len()..]);\n let mut span = Element::new(\"span\");\n span.insert_attr(\"class\", \"boring\".into());\n let mut span = root.append(Node::Element(span));\n span.append(Node::Text(format!(\"{ws}{rest}\\n\").into()));\n } else {\n root.append(Node::Text(format!(\"{line}\\n\").into()));\n }\n }\n tree\n}\n\n/// If this code text is missing an `fn main`, the wrap it with `fn main` in a\n/// fashion similar to rustdoc, with the wrapper hidden.\npub(crate) fn wrap_rust_main(text: &str) -> Option {\n if !text.contains(\"fn main\") && !text.contains(\"quick_main!\") {\n let (attrs, code) = partition_rust_source(text);\n let newline = if code.is_empty() || code.ends_with('\\n') {\n \"\"\n } else {\n \"\\n\"\n };\n Some(format!(\n \"# #![allow(unused)]\\n{attrs}# fn main() {{\\n{code}{newline}# }}\"\n ))\n } else {\n None\n }\n}\n\n/// Splits Rust inner attributes from the given source string.\n///\n/// Returns `(inner_attrs, rest_of_code)`.\nfn partition_rust_source(s: &str) -> (&str, &str) {\n static_regex!(\n HEADER_RE,\n r\"^(?mx)\n (\n (?:\n ^[ \\t]*\\#!\\[.* (?:\\r?\\n)?\n |\n ^\\s* (?:\\r?\\n)?\n )*\n )\"\n );\n let split_idx = match HEADER_RE.captures(s) {\n Some(caps) => {\n let attributes = &caps[1];\n if attributes.trim().is_empty() {\n // Don't include pure whitespace as an attribute. The\n // whitespace in the regex is intended to handle multiple\n // attributes *separated* by potential whitespace.\n 0\n } else {\n attributes.len()\n }\n }\n None => 0,\n };\n s.split_at(split_idx)\n}\n\n#[test]\nfn it_partitions_rust_source() {\n assert_eq!(partition_rust_source(\"\"), (\"\", \"\"));\n assert_eq!(partition_rust_source(\"let x = 1;\"), (\"\", \"let x = 1;\"));\n assert_eq!(\n partition_rust_source(\"fn main()\\n{ let x = 1; }\\n\"),\n (\"\", \"fn main()\\n{ let x = 1; }\\n\")\n );\n assert_eq!(\n partition_rust_source(\"#![allow(foo)]\"),\n (\"#![allow(foo)]\", \"\")\n );\n assert_eq!(\n partition_rust_source(\"#![allow(foo)]\\n\"),\n (\"#![allow(foo)]\\n\", \"\")\n );\n assert_eq!(\n partition_rust_source(\"#![allow(foo)]\\nlet x = 1;\"),\n (\"#![allow(foo)]\\n\", \"let x = 1;\")\n );\n assert_eq!(\n partition_rust_source(\n \"\\n\\\n #![allow(foo)]\\n\\\n \\n\\\n #![allow(bar)]\\n\\\n \\n\\\n let x = 1;\"\n ),\n (\"\\n#![allow(foo)]\\n\\n#![allow(bar)]\\n\\n\", \"let x = 1;\")\n );\n assert_eq!(\n partition_rust_source(\" // Example\"),\n (\"\", \" // Example\")\n );\n}\n" }, { "path": "crates/mdbook-html/src/html/mod.rs", "content": "//! HTML rendering support.\n//!\n//! This module's primary entry point is [`render_markdown`] which will take\n//! markdown text and render it to HTML. In summary, the general procedure of\n//! that function is:\n//!\n//! 1. Use [`pulldown_cmark`] to parse the markdown and generate events.\n//! 2. [`tree`] converts those events to a tree data structure.\n//! 1. Parse HTML inside the markdown using [`tokenizer`].\n//! 2. Apply various transformations to the tree data structure, such as adding header links.\n//! 3. Serialize the tree to HTML in [`serialize()`].\n\nuse ego_tree::Tree;\nuse mdbook_core::book::{Book, Chapter};\nuse mdbook_core::config::{HtmlConfig, RustEdition};\nuse mdbook_markdown::{MarkdownOptions, new_cmark_parser};\nuse std::path::{Path, PathBuf};\n\nmod admonitions;\nmod hide_lines;\nmod print;\nmod serialize;\n#[cfg(test)]\nmod tests;\nmod tokenizer;\nmod tree;\n\npub(crate) use hide_lines::{hide_lines, wrap_rust_main};\npub(crate) use print::render_print_page;\npub(crate) use serialize::serialize;\npub(crate) use tree::{Element, Node};\n\n/// Options for converting a single chapter's markdown to HTML.\npub(crate) struct HtmlRenderOptions<'a> {\n /// Options for parsing markdown.\n pub markdown_options: MarkdownOptions,\n /// The chapter's location, relative to the `SUMMARY.md` file.\n pub path: &'a Path,\n /// The default Rust edition, used to set the proper class on the code blocks.\n pub edition: Option,\n /// The [`HtmlConfig`], whose options affect how the HTML is generated.\n pub config: &'a HtmlConfig,\n}\n\nimpl<'a> HtmlRenderOptions<'a> {\n /// Creates a new [`HtmlRenderOptions`].\n pub(crate) fn new(\n path: &'a Path,\n config: &'a HtmlConfig,\n edition: Option,\n ) -> HtmlRenderOptions<'a> {\n let mut markdown_options = MarkdownOptions::default();\n markdown_options.smart_punctuation = config.smart_punctuation;\n markdown_options.definition_lists = config.definition_lists;\n markdown_options.admonitions = config.admonitions;\n HtmlRenderOptions {\n markdown_options,\n path,\n edition,\n config,\n }\n }\n}\n\n/// Renders markdown to HTML.\npub(crate) fn render_markdown(text: &str, options: &HtmlRenderOptions<'_>) -> String {\n let tree = build_tree(text, options);\n let mut output = String::new();\n serialize::serialize(&tree, &mut output);\n output\n}\n\n/// Renders markdown to a [`Tree`].\nfn build_tree(text: &str, options: &HtmlRenderOptions<'_>) -> Tree {\n let events = new_cmark_parser(text, &options.markdown_options);\n tree::MarkdownTreeBuilder::build(options, events)\n}\n\n/// The parsed chapter, and some information about the chapter.\npub(crate) struct ChapterTree<'book> {\n pub(crate) chapter: &'book Chapter,\n /// The path to the chapter relative to the root with the `.html` extension.\n pub(crate) html_path: PathBuf,\n /// The chapter tree.\n pub(crate) tree: Tree,\n}\n\n/// Creates all of the [`ChapterTree`]s for the book.\npub(crate) fn build_trees<'book>(\n book: &'book Book,\n html_config: &HtmlConfig,\n edition: Option,\n) -> Vec> {\n book.chapters()\n .map(|ch| {\n let path = ch.path.as_ref().unwrap();\n let html_path = ch.path.as_ref().unwrap().with_extension(\"html\");\n let options = HtmlRenderOptions::new(path, html_config, edition);\n let tree = build_tree(&ch.content, &options);\n\n ChapterTree {\n chapter: ch,\n html_path,\n tree,\n }\n })\n .collect()\n}\n" }, { "path": "crates/mdbook-html/src/html/print.rs", "content": "//! Support for generating the print page.\n//!\n//! The print page takes all the individual chapters (as `Tree`\n//! elements) and modifies the chapters so that they work on a consolidated\n//! print page, and then serializes it all as one HTML page.\n\nuse super::Node;\nuse crate::html::{ChapterTree, Element, serialize};\nuse crate::utils::{ToUrlPath, id_from_content, normalize_path, unique_id};\nuse mdbook_core::static_regex;\nuse std::collections::{HashMap, HashSet};\nuse std::path::PathBuf;\n\n/// Takes all the chapter trees, modifies them to be suitable to render for\n/// the print page, and returns an string of all the chapters rendered to a\n/// single HTML page.\npub(crate) fn render_print_page(mut chapter_trees: Vec>) -> String {\n let (id_remap, mut id_counter) = make_ids_unique(&mut chapter_trees);\n let path_to_root_id = make_root_id_map(&mut chapter_trees, &mut id_counter);\n rewrite_links(&mut chapter_trees, &id_remap, &path_to_root_id);\n\n let mut print_content = String::new();\n for ChapterTree { tree, .. } in chapter_trees {\n if !print_content.is_empty() {\n // Add page break between chapters\n // See https://developer.mozilla.org/en-US/docs/Web/CSS/break-before and https://developer.mozilla.org/en-US/docs/Web/CSS/page-break-before\n // Add both two CSS properties because of the compatibility issue\n print_content\n .push_str(r#\"
\"#);\n }\n serialize(&tree, &mut print_content);\n }\n print_content\n}\n\n/// Make all IDs unique, and create a map from old to new IDs.\n///\n/// The first map is a map of the chapter path to the IDs that were rewritten\n/// in that chapter (old ID to new ID).\n///\n/// The second map is a map of every ID seen to the number of times it has\n/// been seen. This is used to generate unique IDs.\nfn make_ids_unique(\n chapter_trees: &mut [ChapterTree<'_>],\n) -> (HashMap>, HashSet) {\n let mut id_remap = HashMap::new();\n let mut id_counter = HashSet::new();\n for ChapterTree {\n html_path, tree, ..\n } in chapter_trees\n {\n for value in tree.values_mut() {\n if let Node::Element(el) = value\n && let Some(id) = el.attr(\"id\")\n {\n let new_id = unique_id(id, &mut id_counter);\n if new_id != id {\n let id = id.to_string();\n el.insert_attr(\"id\", new_id.clone().into());\n\n let map: &mut HashMap<_, _> = id_remap.entry(html_path.clone()).or_default();\n map.insert(id, new_id);\n }\n }\n }\n }\n (id_remap, id_counter)\n}\n\n/// Generates a map of a chapter path to the ID of the top of the chapter.\n///\n/// If a chapter is missing an `h1` tag, then one is synthesized so that the\n/// print output has something to link to.\nfn make_root_id_map(\n chapter_trees: &mut [ChapterTree<'_>],\n id_counter: &mut HashSet,\n) -> HashMap {\n let mut path_to_root_id = HashMap::new();\n for ChapterTree {\n chapter,\n html_path,\n tree,\n ..\n } in chapter_trees\n {\n let mut h1_found = false;\n for value in tree.values_mut() {\n if let Node::Element(el) = value {\n if el.name() == \"h1\" {\n if let Some(id) = el.attr(\"id\") {\n h1_found = true;\n path_to_root_id.insert(html_path.clone(), id.to_string());\n }\n break;\n } else if matches!(el.name(), \"h2\" | \"h3\" | \"h4\" | \"h5\" | \"h6\") {\n // h1 not found.\n break;\n }\n }\n }\n if !h1_found {\n // Synthesize a root id to be able to link to the start of the page.\n // TODO: This might want to be a warning? Chapters generally\n // should start with an h1.\n let mut h1 = Element::new(\"h1\");\n let id = id_from_content(&chapter.name);\n let id = unique_id(&id, id_counter);\n h1.insert_attr(\"id\", id.clone().into());\n let mut root = tree.root_mut();\n let mut h1 = root.prepend(Node::Element(h1));\n let mut a = Element::new(\"a\");\n a.insert_attr(\"href\", format!(\"#{id}\").into());\n a.insert_attr(\"class\", \"header\".into());\n let mut a = h1.append(Node::Element(a));\n a.append(Node::Text(chapter.name.clone().into()));\n path_to_root_id.insert(html_path.clone(), id);\n }\n }\n\n path_to_root_id\n}\n\n/// Rewrite links so that they point to IDs on the print page.\nfn rewrite_links(\n chapter_trees: &mut [ChapterTree<'_>],\n id_remap: &HashMap>,\n path_to_root_id: &HashMap,\n) {\n static_regex!(\n LINK,\n r\"(?x)\n (?P^[a-z][a-z0-9+.-]*:)?\n (?P[^\\#]+)?\n (?:\\#(?P.*))?\"\n );\n\n // Rewrite path links to go to the appropriate place.\n for ChapterTree {\n html_path, tree, ..\n } in chapter_trees\n {\n let base = html_path.parent().expect(\"path can't be empty\");\n\n for value in tree.values_mut() {\n let Node::Element(el) = value else {\n continue;\n };\n if !matches!(el.name(), \"a\" | \"img\") {\n continue;\n }\n for attr in [\"href\", \"src\", \"xlink:href\"] {\n let Some(dest) = el.attr(attr) else {\n continue;\n };\n let Some(caps) = LINK.captures(&dest) else {\n continue;\n };\n if caps.name(\"scheme\").is_some() {\n continue;\n }\n // The lookup_key is the key to look up in the remap table.\n let mut lookup_key = html_path.clone();\n if let Some(href_path) = caps.name(\"path\")\n && let href_path = href_path.as_str()\n && !href_path.is_empty()\n {\n lookup_key.pop();\n lookup_key.push(href_path);\n lookup_key = normalize_path(&lookup_key);\n let is_a_chapter = path_to_root_id.contains_key(&lookup_key);\n if !is_a_chapter {\n // Make the link relative to the print page location.\n let mut rel_path = normalize_path(&base.join(href_path)).to_url_path();\n if let Some(anchor) = caps.name(\"anchor\") {\n rel_path.push('#');\n rel_path.push_str(anchor.as_str());\n }\n el.insert_attr(attr, rel_path.into());\n continue;\n }\n }\n\n let id = match caps.name(\"anchor\") {\n Some(anchor_id) => {\n let anchor_id = anchor_id.as_str().to_string();\n match id_remap.get(&lookup_key) {\n Some(id_map) => match id_map.get(&anchor_id) {\n Some(new_id) => new_id.clone(),\n None => anchor_id,\n },\n None => {\n // Assume the anchor goes to some non-remapped\n // ID that already exists.\n anchor_id\n }\n }\n }\n None => match path_to_root_id.get(&lookup_key) {\n Some(id) => id.to_string(),\n None => {\n // This should be guaranteed that either the\n // chapter itself is in the map (for anchor-only\n // links), or the is_a_chapter check above.\n panic!(\n \"internal error: expected `{lookup_key:?}` to be in \\\n root map (chapter path is `{html_path:?}`)\"\n );\n }\n },\n };\n el.insert_attr(attr, format!(\"#{id}\").into());\n }\n }\n }\n}\n" }, { "path": "crates/mdbook-html/src/html/serialize.rs", "content": "//! Serializes the [`Node`] tree to an HTML string.\n\nuse super::tree::is_void_element;\nuse super::tree::{Element, Node};\nuse ego_tree::{Tree, iter::Edge};\nuse html5ever::{local_name, ns};\nuse mdbook_core::utils::{escape_html, escape_html_attribute};\nuse std::ops::Deref;\n\n/// Serializes the given tree of [`Node`] elements to an HTML string.\npub(crate) fn serialize(tree: &Tree, output: &mut String) {\n for edge in tree.root().traverse() {\n match edge {\n Edge::Open(node) => match node.value() {\n Node::Element(el) => serialize_start(el, output),\n Node::Text(text) => {\n output.push_str(&escape_html(text));\n }\n Node::Comment(comment) => {\n output.push_str(\"\");\n }\n Node::Fragment => {}\n Node::RawData(html) => {\n output.push_str(html);\n }\n },\n Edge::Close(node) => {\n if let Node::Element(el) = node.value() {\n serialize_end(el, output);\n }\n }\n }\n }\n}\n\n/// Returns true if this HTML element wants a newline to keep the emitted\n/// output more readable.\nfn wants_pretty_html_newline(name: &str) -> bool {\n matches!(name, |\"blockquote\"| \"dd\"\n | \"div\"\n | \"dl\"\n | \"dt\"\n | \"h1\"\n | \"h2\"\n | \"h3\"\n | \"h4\"\n | \"h5\"\n | \"h6\"\n | \"hr\"\n | \"li\"\n | \"ol\"\n | \"p\"\n | \"pre\"\n | \"table\"\n | \"tbody\"\n | \"thead\"\n | \"tr\"\n | \"ul\")\n}\n\n/// Emit the start tag of an element.\nfn serialize_start(el: &Element, output: &mut String) {\n let el_name = el.name();\n if wants_pretty_html_newline(el_name) {\n if !output.is_empty() {\n if !output.ends_with('\\n') {\n output.push('\\n');\n }\n }\n }\n output.push('<');\n output.push_str(el_name);\n for (attr_name, value) in &el.attrs {\n output.push(' ');\n match attr_name.ns {\n ns!() => (),\n ns!(xml) => output.push_str(\"xml:\"),\n ns!(xmlns) => {\n if el.name.local != local_name!(\"xmlns\") {\n output.push_str(\"xmlns:\");\n }\n }\n ns!(xlink) => output.push_str(\"xlink:\"),\n _ => (), // TODO what should it do here?\n }\n output.push_str(attr_name.local.deref());\n output.push_str(\"=\\\"\");\n output.push_str(&escape_html_attribute(&value));\n output.push('\"');\n }\n if el.self_closing {\n output.push_str(\" /\");\n }\n output.push('>');\n}\n\n/// Emit the end tag of an element.\nfn serialize_end(el: &Element, output: &mut String) {\n // Void elements do not have an end tag.\n if el.self_closing || is_void_element(el.name()) {\n return;\n }\n let name = el.name();\n output.push_str(\"');\n if wants_pretty_html_newline(name) {\n output.push('\\n');\n }\n}\n" }, { "path": "crates/mdbook-html/src/html/tests.rs", "content": "use crate::html::tokenizer::parse_html;\nuse html5ever::tokenizer::{Tag, TagKind, Token};\n\n// Basic tokenizer behavior of a script.\n#[test]\nfn parse_html_script() {\n let script = r#\"\nif (3 < 5 > 10)\n{\n alert(\"The sky is falling!\");\n}\n\"#;\n let t = format!(\"\");\n let ts = parse_html(&t);\n eprintln!(\"{ts:#?}\",);\n let mut output = String::new();\n let mut in_script = false;\n for t in ts {\n match t {\n Token::ParseError(e) => panic!(\"{e:?}\"),\n Token::CharacterTokens(s) => {\n if in_script {\n output.push_str(&s)\n }\n }\n Token::TagToken(Tag {\n kind: TagKind::StartTag,\n ..\n }) => in_script = true,\n Token::TagToken(Tag {\n kind: TagKind::EndTag,\n ..\n }) => in_script = false,\n _ => {}\n }\n }\n assert_eq!(output, script);\n}\n\n// What happens if a script doesn't end.\n#[test]\nfn parse_html_script_unclosed() {\n let t = r#\"\n```\n\n### resource\n\nThe path to a static file.\nIt implicitly includes `path_to_root`,\nand accounts for files that are renamed with a hash in their filename.\n\n```handlebars\n\n```\n\n### fa\n\nmdBook includes a copy of [Font Awesome Free's](https://fontawesome.com)\nMIT-licensed SVG files. It accepts three positional arguments:\n\n1. Type: one of \"solid\", \"regular\", and \"brands\" (light and duotone are not\n currently supported)\n2. Icon: anything chosen from the\n [free icon set](https://fontawesome.com/v6/search)\n3. ID (optional): if included, an HTML ID attribute will be added to the\n icon's wrapping `` tag\n\nFor example, this handlebars syntax will become this HTML:\n\n```handlebars\n{{fa \"solid\" \"print\" \"print-button\"}}\n```\n\n```html\n\n```\n" }, { "path": "guide/src/format/theme/syntax-highlighting.md", "content": "# Syntax highlighting\n\nmdBook uses [Highlight.js](https://highlightjs.org) with a custom theme\nfor syntax highlighting.\n\nAutomatic language detection has been turned off, so you will probably want to\nspecify the programming language you use like this:\n\n~~~markdown\n```rust\nfn main() {\n // Some code\n}\n```\n~~~\n\n## Supported languages\n\nThese languages are supported by default, but you can add more by supplying\nyour own `highlight.js` file:\n\n- apache\n- armasm\n- bash\n- c\n- coffeescript\n- cpp\n- csharp\n- css\n- d\n- diff\n- go\n- handlebars\n- haskell\n- http\n- ini\n- java\n- javascript\n- json\n- julia\n- kotlin\n- less\n- lua\n- makefile\n- markdown\n- nginx\n- nim\n- nix\n- objectivec\n- perl\n- php\n- plaintext\n- properties\n- python\n- r\n- ruby\n- rust\n- scala\n- scss\n- shell\n- sql\n- swift\n- typescript\n- x86asm\n- xml\n- yaml\n\n## Custom theme\nLike the rest of the theme, the files used for syntax highlighting can be\noverridden with your own.\n\n- ***highlight.js*** normally you shouldn't have to overwrite this file, unless\n you want to use a more recent version.\n- ***highlight.css*** theme used by highlight.js for syntax highlighting.\n\nIf you want to use another theme for `highlight.js` download it from their\nwebsite, or make it yourself, rename it to `highlight.css` and put it in\nthe `theme` folder of your book.\n\nNow your theme will be used instead of the default theme.\n\n## Improve default theme\n\nIf you think the default theme doesn't look quite right for a specific language,\nor could be improved, feel free to [submit a new\nissue](https://github.com/rust-lang/mdBook/issues) explaining what you\nhave in mind and I will take a look at it.\n\nYou could also create a pull-request with the proposed improvements.\n\nOverall the theme should be light and sober, without too many flashy colors.\n" }, { "path": "guide/src/guide/README.md", "content": "# User guide\n\nThis user guide provides an introduction to basic concepts of using mdBook.\n\n- [Installation](installation.md)\n- [Reading Books](reading.md)\n- [Creating a Book](creating.md)\n" }, { "path": "guide/src/guide/creating.md", "content": "# Creating a book\n\nOnce you have the `mdbook` CLI tool installed, you can use it to create and render a book.\n\n## Initializing a book\n\nThe `mdbook init` command will create a new directory containing an empty book for you to get started.\nGive it the name of the directory that you want to create:\n\n```sh\nmdbook init my-first-book\n```\n\nIt will ask a few questions before generating the book.\nAfter answering the questions, you can change the current directory into the new book:\n\n```sh\ncd my-first-book\n```\n\nThere are several ways to render a book, but one of the easiest methods is to use the `serve` command, which will build your book and start a local webserver:\n\n```sh\nmdbook serve --open\n```\n\nThe `--open` option will open your default web browser to view your new book.\nYou can leave the server running even while you edit the content of the book, and `mdbook` will automatically rebuild the output *and* automatically refresh your web browser.\n\nCheck out the [CLI Guide](../cli/index.html) for more information about other `mdbook` commands and CLI options.\n\n## Anatomy of a book\n\nA book is built from several files which define the settings and layout of the book.\n\n### `book.toml`\n\nIn the root of your book, there is a `book.toml` file which contains settings for describing how to build your book.\nThis is written in the [TOML markup language](https://toml.io/).\nThe default settings are usually good enough to get you started.\nWhen you are interested in exploring more features and options that mdBook provides, check out the [Configuration chapter](../format/configuration/index.html) for more details.\n\nA very basic `book.toml` can be as simple as this:\n\n```toml\n[book]\ntitle = \"My First Book\"\n```\n\n### `SUMMARY.md`\n\nThe next major part of a book is the summary file located at `src/SUMMARY.md`.\nThis file contains a list of all the chapters in the book.\nBefore a chapter can be viewed, it must be added to this list.\n\nHere's a basic summary file with a few chapters:\n\n```md\n# Summary\n\n[Introduction](README.md)\n\n- [My First Chapter](my-first-chapter.md)\n- [Nested example](nested/README.md)\n - [Sub-chapter](nested/sub-chapter.md)\n```\n\nTry opening up `src/SUMMARY.md` in your editor and adding a few chapters.\nIf any of the chapter files do not exist, `mdbook` will automatically create them for you.\n\nFor more details on other formatting options for the summary file, check out the [Summary chapter](../format/summary.md).\n\n### Source files\n\nThe content of your book is all contained in the `src` directory.\nEach chapter is a separate Markdown file.\nTypically, each chapter starts with a level 1 heading with the title of the chapter.\n\n```md\n# My First Chapter\n\nFill out your content here.\n```\n\nThe precise layout of the files is up to you.\nThe organization of the files will correspond to the HTML files generated, so keep in mind that the file layout is part of the URL of each chapter.\n\nWhile the `mdbook serve` command is running, you can open any of the chapter files and start editing them.\nEach time you save the file, `mdbook` will rebuild the book and refresh your web browser.\n\nCheck out the [Markdown chapter](../format/markdown.md) for more information on formatting the content of your chapters.\n\nAll other files in the `src` directory will be included in the output.\nSo if you have images or other static files, just include them somewhere in the `src` directory.\n\n## Publishing a book\n\nOnce you've written your book, you may want to host it somewhere for others to view.\nThe first step is to build the output of the book.\nThis can be done with the `mdbook build` command in the same directory where the `book.toml` file is located:\n\n```sh\nmdbook build\n```\n\nThis will generate a directory named `book` which contains the HTML content of your book.\nYou can then place this directory on any web server to host it.\n\nFor more information about publishing and deploying, check out the [Continuous Integration chapter](../continuous-integration.md) for more.\n" }, { "path": "guide/src/guide/installation.md", "content": "# Installation\n\nThere are multiple ways to install the mdBook CLI tool.\nChoose any one of the methods below that best suit your needs.\nIf you are installing mdBook for automatic deployment, check out the [continuous integration] chapter for more examples on how to install.\n\n[continuous integration]: ../continuous-integration.md\n\n## Pre-compiled binaries\n\nExecutable binaries are available for download on the [GitHub Releases page][releases].\nDownload the binary for your platform (Windows, macOS, or Linux) and extract the archive.\nThe archive contains an `mdbook` executable which you can run to build your books.\n\nTo make it easier to run, put the path to the binary into your `PATH`.\n\n[releases]: https://github.com/rust-lang/mdBook/releases\n\n## Build from source using Rust\n\nTo build the `mdbook` executable from source, you will first need to install Rust and Cargo.\nFollow the instructions on the [Rust installation page].\nmdBook currently requires at least Rust version 1.88.\n\nOnce you have installed Rust, the following command can be used to build and install mdBook:\n\n```sh\ncargo install mdbook\n```\n\nThis will automatically download mdBook from [crates.io], build it, and install it in Cargo's global binary directory (`~/.cargo/bin/` by default).\n\nYou can run `cargo install mdbook` again whenever you want to update to a new version.\nThat command will check if there is a newer version, and re-install mdBook if a newer version is found.\n\nTo uninstall, run the command `cargo uninstall mdbook`.\n\n[Rust installation page]: https://www.rust-lang.org/tools/install\n[crates.io]: https://crates.io/\n\n### Installing the latest master version\n\nThe version published to crates.io will ever so slightly be behind the version hosted on GitHub.\nIf you need the latest version you can build the git version of mdBook yourself.\nCargo makes this ***super easy***!\n\n```sh\ncargo install --git https://github.com/rust-lang/mdBook.git mdbook\n```\n\nAgain, make sure to add the Cargo bin directory to your `PATH`.\n\n## Modifying and contributing\n\nIf you are interested in making modifications to mdBook itself, check out the [Contributing Guide] for more information.\n\n[Contributing Guide]: https://github.com/rust-lang/mdBook/blob/master/CONTRIBUTING.md\n" }, { "path": "guide/src/guide/reading.md", "content": "# Reading books\n\nThis chapter gives an introduction on how to interact with a book produced by mdBook.\nThis assumes you are reading an HTML book.\nThe options and formatting will be different for other output formats such as PDF.\n\nA book is organized into *chapters*.\nEach chapter is a separate page.\nChapters can be nested into a hierarchy of sub-chapters.\nTypically, each chapter will be organized into a series of *headings* to subdivide a chapter.\n\n## Navigation\n\nThere are several methods for navigating through the chapters of a book.\n\nThe **sidebar** on the left provides a list of all chapters.\nClicking on any of the chapter titles will load that page.\n\nThe sidebar may not automatically appear if the window is too narrow, particularly on mobile displays.\nIn that situation, the menu icon (three horizontal bars) at the top-left of the page can be pressed to open and close the sidebar.\n\nThe **arrow buttons** at the bottom of the page can be used to navigate to the previous or the next chapter.\n\nThe **left and right arrow keys** on the keyboard can be used to navigate to the previous or the next chapter.\n\n## Top menu bar\n\nThe menu bar at the top of the page provides some icons for interacting with the book.\nThe icons displayed will depend on the settings of how the book was generated.\n\n| Icon | Description |\n|------|-------------|\n| | Opens and closes the chapter listing sidebar. |\n| | Opens a picker to choose a different color theme. |\n| | Opens a search bar for searching within the book. |\n| | Instructs the web browser to print the entire book. |\n| | Opens a link to the website that hosts the source code of the book. |\n| | Opens a page to directly edit the source of the page you are currently reading. |\n\nTapping the menu bar will scroll the page to the top.\n\n## Search\n\nEach book has a built-in search system.\nPressing the search icon in the menu bar, or pressing the / or S key on the keyboard will open an input box for entering search terms.\nTyping some terms will show matching chapters and sections in real time.\n\nClicking any of the results will jump to that section.\nThe up and down arrow keys can be used to navigate the results, and enter will open the highlighted section.\n\nAfter loading a search result, the matching search terms will be highlighted in the text.\nClicking a highlighted word or pressing the Escape key will remove the highlighting.\n\n## Code blocks\n\nmdBook books are often used for programming projects, and thus support highlighting code blocks and samples.\nCode blocks may contain several different icons for interacting with them:\n\n| Icon | Description |\n|------|-------------|\n| | Copies the code block into your local clipboard, to allow pasting into another application. |\n| | For Rust code examples, this will execute the sample code and display the compiler output just below the example (see [playground]). |\n| | For Rust code examples, this will toggle visibility of \"hidden\" lines. Sometimes, larger examples will hide lines which are not particularly relevant to what is being illustrated (see [hiding code lines]). |\n| | For [editable code examples][editor], this will undo any changes you have made. |\n\nHere's an example:\n\n```rust\nprintln!(\"Hello, World!\");\n```\n\n[editor]: ../format/theme/editor.md\n[playground]: ../format/mdbook.md#rust-playground\n[hiding code lines]: ../format/mdbook.md#hiding-code-lines\n" }, { "path": "guide/src/misc/contributors.md", "content": "# Contributors\n\nHere is a list of the contributors who have helped improving mdBook. Big\nshout-out to them!\n\n- [mdinger](https://github.com/mdinger)\n- Kevin ([kbknapp](https://github.com/kbknapp))\n- Steve Klabnik ([steveklabnik](https://github.com/steveklabnik))\n- Adam Solove ([asolove](https://github.com/asolove))\n- Wayne Nilsen ([waynenilsen](https://github.com/waynenilsen))\n- [funnkill](https://github.com/funkill)\n- Fu Gangqiang ([FuGangqiang](https://github.com/FuGangqiang))\n- [Michael-F-Bryan](https://github.com/Michael-F-Bryan)\n- Chris Spiegel ([cspiegel](https://github.com/cspiegel))\n- [projektir](https://github.com/projektir)\n- [Phaiax](https://github.com/Phaiax)\n- Matt Ickstadt ([mattico](https://github.com/mattico))\n- Weihang Lo ([weihanglo](https://github.com/weihanglo))\n- Avision Ho ([avisionh](https://github.com/avisionh))\n- Vivek Akupatni ([apatniv](https://github.com/apatniv))\n- Eric Huss ([ehuss](https://github.com/ehuss))\n- Josh Rotenberg ([joshrotenberg](https://github.com/joshrotenberg))\n\nIf you feel you're missing from this list, feel free to add yourself in a PR.\n" }, { "path": "rustfmt.toml", "content": "style_edition = \"2024\"\n" }, { "path": "src/cmd/build.rs", "content": "use super::command_prelude::*;\nuse crate::{get_book_dir, open};\nuse anyhow::Result;\nuse mdbook_driver::MDBook;\nuse tracing::error;\n\n// Create clap subcommand arguments\npub fn make_subcommand() -> Command {\n Command::new(\"build\")\n .about(\"Builds a book from its markdown files\")\n .arg_dest_dir()\n .arg_root_dir()\n .arg_open()\n}\n\n// Build command implementation\npub fn execute(args: &ArgMatches) -> Result<()> {\n let book_dir = get_book_dir(args);\n let mut book = MDBook::load(book_dir)?;\n\n set_dest_dir(args, &mut book);\n\n book.build()?;\n\n if args.get_flag(\"open\") {\n // FIXME: What's the right behaviour if we don't use the HTML renderer?\n let path = book.build_dir_for(\"html\").join(\"index.html\");\n if !path.exists() {\n error!(\"No chapter available to open\");\n std::process::exit(1)\n }\n open(path);\n }\n\n Ok(())\n}\n" }, { "path": "src/cmd/clean.rs", "content": "use super::command_prelude::*;\nuse crate::get_book_dir;\nuse anyhow::Context;\nuse anyhow::Result;\nuse mdbook_driver::MDBook;\nuse std::mem::take;\nuse std::path::PathBuf;\nuse std::{fmt, fs};\n\n// Create clap subcommand arguments\npub fn make_subcommand() -> Command {\n Command::new(\"clean\")\n .about(\"Deletes a built book\")\n .arg_dest_dir()\n .arg_root_dir()\n}\n\n// Clean command implementation\npub fn execute(args: &ArgMatches) -> Result<()> {\n let book_dir = get_book_dir(args);\n let book = MDBook::load(book_dir)?;\n\n let dir_to_remove = match args.get_one::(\"dest-dir\") {\n Some(dest_dir) => std::env::current_dir()\n .expect(\"current dir should be valid\")\n .join(dest_dir),\n None => book.root.join(&book.config.build.build_dir),\n };\n\n let removed = Clean::new(&dir_to_remove)?;\n println!(\"{removed}\");\n\n Ok(())\n}\n\n/// Formats a number of bytes into a human readable SI-prefixed size.\n/// Returns a tuple of `(quantity, units)`.\npub fn human_readable_bytes(bytes: u64) -> (f32, &'static str) {\n static UNITS: [&str; 7] = [\"B\", \"KiB\", \"MiB\", \"GiB\", \"TiB\", \"PiB\", \"EiB\"];\n let bytes = bytes as f32;\n let i = ((bytes.log2() / 10.0) as usize).min(UNITS.len() - 1);\n (bytes / 1024_f32.powi(i as i32), UNITS[i])\n}\n\n#[derive(Debug)]\npub struct Clean {\n num_files_removed: u64,\n num_dirs_removed: u64,\n total_bytes_removed: u64,\n}\n\nimpl Clean {\n fn new(dir: &PathBuf) -> Result {\n let mut files = vec![dir.clone()];\n let mut children = Vec::new();\n let mut num_files_removed = 0;\n let mut num_dirs_removed = 0;\n let mut total_bytes_removed = 0;\n\n if dir.exists() {\n while !files.is_empty() {\n for file in files {\n if let Ok(meta) = file.metadata() {\n // Note: This can over-count bytes removed for hard-linked\n // files. It also under-counts since it only counts the exact\n // byte sizes and not the block sizes.\n total_bytes_removed += meta.len();\n }\n if file.is_file() {\n num_files_removed += 1;\n } else if file.is_dir() {\n num_dirs_removed += 1;\n for entry in fs::read_dir(file)? {\n children.push(entry?.path());\n }\n }\n }\n files = take(&mut children);\n }\n fs::remove_dir_all(&dir).with_context(|| \"Unable to remove the build directory\")?;\n }\n\n Ok(Clean {\n num_files_removed,\n num_dirs_removed,\n total_bytes_removed,\n })\n }\n}\n\nimpl fmt::Display for Clean {\n fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {\n write!(f, \"Removed \")?;\n match (self.num_files_removed, self.num_dirs_removed) {\n (0, 0) => write!(f, \"0 files\")?,\n (0, 1) => write!(f, \"1 directory\")?,\n (0, 2..) => write!(f, \"{} directories\", self.num_dirs_removed)?,\n (1, _) => write!(f, \"1 file\")?,\n (2.., _) => write!(f, \"{} files\", self.num_files_removed)?,\n }\n\n if self.total_bytes_removed == 0 {\n Ok(())\n } else {\n // Don't show a fractional number of bytes.\n if self.total_bytes_removed < 1024 {\n write!(f, \", {}B total\", self.total_bytes_removed)\n } else {\n let (bytes, unit) = human_readable_bytes(self.total_bytes_removed);\n write!(f, \", {bytes:.2}{unit} total\")\n }\n }\n }\n}\n" }, { "path": "src/cmd/command_prelude.rs", "content": "//! Helpers for building the command-line arguments for commands.\n\npub use clap::{Arg, ArgMatches, Command, arg};\nuse mdbook_driver::MDBook;\nuse std::path::PathBuf;\n\npub trait CommandExt: Sized {\n fn _arg(self, arg: Arg) -> Self;\n\n fn arg_dest_dir(self) -> Self {\n self._arg(\n Arg::new(\"dest-dir\")\n .short('d')\n .long(\"dest-dir\")\n .value_name(\"dest-dir\")\n .value_parser(clap::value_parser!(PathBuf))\n .help(\n \"Output directory for the book\\n\\\n Relative paths are interpreted relative to the current directory.\\n\\\n If omitted, mdBook uses build.build-dir from book.toml \\\n or defaults to `./book`.\",\n ),\n )\n }\n\n fn arg_root_dir(self) -> Self {\n self._arg(\n Arg::new(\"dir\")\n .help(\n \"Root directory for the book\\n\\\n (Defaults to the current directory when omitted)\",\n )\n .value_parser(clap::value_parser!(PathBuf)),\n )\n }\n\n fn arg_open(self) -> Self {\n self._arg(arg!(-o --open \"Opens the compiled book in a web browser\"))\n }\n\n #[cfg(any(feature = \"watch\", feature = \"serve\"))]\n fn arg_watcher(self) -> Self {\n #[cfg(feature = \"watch\")]\n return self._arg(\n Arg::new(\"watcher\")\n .long(\"watcher\")\n .value_parser([\"poll\", \"native\"])\n .default_value(\"poll\")\n .help(\"The filesystem watching technique\"),\n );\n #[cfg(not(feature = \"watch\"))]\n return self;\n }\n}\n\nimpl CommandExt for Command {\n fn _arg(self, arg: Arg) -> Self {\n self.arg(arg)\n }\n}\n\npub fn set_dest_dir(args: &ArgMatches, book: &mut MDBook) {\n if let Some(dest_dir) = args.get_one::(\"dest-dir\") {\n let build_dir = std::env::current_dir()\n .expect(\"current dir should be valid\")\n .join(dest_dir);\n book.config.build.build_dir = build_dir;\n }\n}\n" }, { "path": "src/cmd/init.rs", "content": "use crate::get_book_dir;\nuse anyhow::Result;\nuse clap::{ArgMatches, Command as ClapCommand, arg};\nuse mdbook_core::config;\nuse mdbook_driver::MDBook;\nuse std::io;\nuse std::io::Write;\nuse std::process::Command;\nuse tracing::debug;\n\n// Create clap subcommand arguments\npub fn make_subcommand() -> ClapCommand {\n ClapCommand::new(\"init\")\n .about(\"Creates the boilerplate structure and files for a new book\")\n .arg(\n arg!([dir]\n \"Directory to create the book in\\n\\\n (Defaults to the current directory when omitted)\"\n )\n .value_parser(clap::value_parser!(std::path::PathBuf)),\n )\n .arg(arg!(--theme \"Copies the default theme into your source folder\"))\n .arg(arg!(--force \"Skips confirmation prompts\"))\n .arg(arg!(--title \"Sets the book title\"))\n .arg(\n arg!(--ignore <ignore> \"Creates a VCS ignore file (i.e. .gitignore)\")\n .value_parser([\"none\", \"git\"]),\n )\n}\n\n// Init command implementation\npub fn execute(args: &ArgMatches) -> Result<()> {\n let book_dir = get_book_dir(args);\n let mut builder = MDBook::init(&book_dir);\n let mut config = config::Config::default();\n // If flag `--theme` is present, copy theme to src\n if args.get_flag(\"theme\") {\n let theme_dir = book_dir.join(\"theme\");\n println!();\n println!(\"Copying the default theme to {}\", theme_dir.display());\n // Skip this if `--force` is present\n if !args.get_flag(\"force\") && theme_dir.exists() {\n println!(\"This could potentially overwrite files already present in that directory.\");\n print!(\"\\nAre you sure you want to continue? (y/n) \");\n\n // Read answer from user and exit if it's not 'yes'\n if confirm() {\n builder.copy_theme(true);\n }\n } else {\n builder.copy_theme(true);\n }\n }\n\n if let Some(ignore) = args.get_one::<String>(\"ignore\").map(|s| s.as_str()) {\n match ignore {\n \"git\" => builder.create_gitignore(true),\n _ => builder.create_gitignore(false),\n };\n } else if !args.get_flag(\"force\") {\n println!(\"\\nDo you want a .gitignore to be created? (y/n)\");\n if confirm() {\n builder.create_gitignore(true);\n }\n }\n\n config.book.title = if args.contains_id(\"title\") {\n args.get_one::<String>(\"title\").map(String::from)\n } else if args.get_flag(\"force\") {\n None\n } else {\n request_book_title()\n };\n\n if let Some(author) = get_author_name() {\n debug!(\"Obtained user name from gitconfig: {:?}\", author);\n config.book.authors.push(author);\n }\n\n builder.with_config(config);\n builder.build()?;\n println!(\"\\nAll done, no errors...\");\n\n Ok(())\n}\n\n/// Obtains author name from git config file by running the `git config` command.\nfn get_author_name() -> Option<String> {\n let output = Command::new(\"git\")\n .args([\"config\", \"--get\", \"user.name\"])\n .output()\n .ok()?;\n\n if output.status.success() {\n Some(String::from_utf8_lossy(&output.stdout).trim().to_owned())\n } else {\n None\n }\n}\n\n/// Request book title from user and return if provided.\nfn request_book_title() -> Option<String> {\n println!(\"What title would you like to give the book? \");\n io::stdout().flush().unwrap();\n let mut resp = String::new();\n io::stdin().read_line(&mut resp).unwrap();\n let resp = resp.trim();\n if resp.is_empty() {\n None\n } else {\n Some(resp.into())\n }\n}\n\n// Simple function for user confirmation\nfn confirm() -> bool {\n io::stdout().flush().unwrap();\n let mut s = String::new();\n io::stdin().read_line(&mut s).ok();\n matches!(s.trim(), \"Y\" | \"y\" | \"yes\" | \"Yes\")\n}\n" }, { "path": "src/cmd/mod.rs", "content": "//! Subcommand modules for the `mdbook` binary.\n\npub mod build;\npub mod clean;\npub mod command_prelude;\npub mod init;\n#[cfg(feature = \"serve\")]\npub mod serve;\npub mod test;\n#[cfg(feature = \"watch\")]\npub mod watch;\n" }, { "path": "src/cmd/serve.rs", "content": "use super::command_prelude::*;\n#[cfg(feature = \"watch\")]\nuse super::watch;\nuse crate::{get_book_dir, open};\nuse anyhow::Result;\nuse axum::Router;\nuse axum::extract::ws::{Message, WebSocket, WebSocketUpgrade};\nuse axum::routing::get;\nuse clap::builder::NonEmptyStringValueParser;\nuse futures_util::StreamExt;\nuse futures_util::sink::SinkExt;\nuse mdbook_driver::MDBook;\nuse std::net::{SocketAddr, ToSocketAddrs};\nuse std::path::PathBuf;\nuse tokio::sync::broadcast;\nuse tower_http::services::{ServeDir, ServeFile};\nuse tracing::{error, info, trace};\n\n/// The HTTP endpoint for the websocket used to trigger reloads when a file changes.\nconst LIVE_RELOAD_ENDPOINT: &str = \"__livereload\";\n\n// Create clap subcommand arguments\npub fn make_subcommand() -> Command {\n Command::new(\"serve\")\n .about(\"Serves a book at http://localhost:3000, and rebuilds it on changes\")\n .arg_dest_dir()\n .arg_root_dir()\n .arg(\n Arg::new(\"hostname\")\n .short('n')\n .long(\"hostname\")\n .num_args(1)\n .default_value(\"localhost\")\n .value_parser(NonEmptyStringValueParser::new())\n .help(\"Hostname to listen on for HTTP connections\"),\n )\n .arg(\n Arg::new(\"port\")\n .short('p')\n .long(\"port\")\n .num_args(1)\n .default_value(\"3000\")\n .value_parser(NonEmptyStringValueParser::new())\n .help(\"Port to use for HTTP connections\"),\n )\n .arg_open()\n .arg_watcher()\n}\n\n// Serve command implementation\npub fn execute(args: &ArgMatches) -> Result<()> {\n let book_dir = get_book_dir(args);\n let mut book = MDBook::load(&book_dir)?;\n\n let port = args.get_one::<String>(\"port\").unwrap();\n let hostname = args.get_one::<String>(\"hostname\").unwrap();\n let open_browser = args.get_flag(\"open\");\n\n let address = format!(\"{hostname}:{port}\");\n\n let update_config = |book: &mut MDBook| {\n book.config\n .set(\"output.html.live-reload-endpoint\", LIVE_RELOAD_ENDPOINT)\n .expect(\"live-reload-endpoint update failed\");\n set_dest_dir(args, book);\n // Override site-url for local serving of the 404 file\n book.config.set(\"output.html.site-url\", \"/\").unwrap();\n };\n update_config(&mut book);\n book.build()?;\n\n let sockaddr: SocketAddr = address\n .to_socket_addrs()?\n .next()\n .ok_or_else(|| anyhow::anyhow!(\"no address found for {}\", address))?;\n let build_dir = book.build_dir_for(\"html\");\n let html_config = book.config.html_config().unwrap_or_default();\n let file_404 = html_config.get_404_output_file();\n\n // A channel used to broadcast to any websockets to reload when a file changes.\n let (tx, _rx) = tokio::sync::broadcast::channel::<Message>(100);\n\n let reload_tx = tx.clone();\n let thread_handle = std::thread::spawn(move || {\n serve(build_dir, sockaddr, reload_tx, &file_404);\n });\n\n let serving_url = format!(\"http://{address}\");\n info!(\"Serving on: {}\", serving_url);\n\n if open_browser {\n open(serving_url);\n }\n\n #[cfg(feature = \"watch\")]\n {\n let watcher = watch::WatcherKind::from_str(args.get_one::<String>(\"watcher\").unwrap());\n watch::rebuild_on_change(watcher, &book_dir, &update_config, &move || {\n let _ = tx.send(Message::text(\"reload\"));\n });\n }\n\n let _ = thread_handle.join();\n\n Ok(())\n}\n\n#[tokio::main]\nasync fn serve(\n build_dir: PathBuf,\n address: SocketAddr,\n reload_tx: broadcast::Sender<Message>,\n file_404: &str,\n) {\n let reload_tx_clone = reload_tx.clone();\n\n // WebSocket handler for live reload\n let websocket_handler = move |ws: WebSocketUpgrade| async move {\n let reload_tx = reload_tx_clone.clone();\n ws.on_upgrade(move |socket| websocket_connection(socket, reload_tx))\n };\n\n let app = Router::new()\n .route(&format!(\"/{LIVE_RELOAD_ENDPOINT}\"), get(websocket_handler))\n .fallback_service(\n ServeDir::new(&build_dir).not_found_service(ServeFile::new(build_dir.join(file_404))),\n );\n\n std::panic::set_hook(Box::new(move |panic_info| {\n // exit if serve panics\n error!(\"Unable to serve: {}\", panic_info);\n std::process::exit(1);\n }));\n\n let listener = tokio::net::TcpListener::bind(&address)\n .await\n .unwrap_or_else(|e| panic!(\"Unable to bind to {address}: {e}\"));\n\n axum::serve(listener, app).await.unwrap();\n}\n\nasync fn websocket_connection(ws: WebSocket, reload_tx: broadcast::Sender<Message>) {\n let (mut user_ws_tx, _user_ws_rx) = ws.split();\n let mut rx = reload_tx.subscribe();\n\n trace!(\"websocket got connection\");\n if let Ok(m) = rx.recv().await {\n trace!(\"notify of reload\");\n let _ = user_ws_tx.send(m).await;\n }\n}\n" }, { "path": "src/cmd/test.rs", "content": "use super::command_prelude::*;\nuse crate::get_book_dir;\nuse anyhow::Result;\nuse clap::ArgAction;\nuse clap::builder::NonEmptyStringValueParser;\nuse mdbook_driver::MDBook;\n\n// Create clap subcommand arguments\npub fn make_subcommand() -> Command {\n Command::new(\"test\")\n .about(\"Tests that a book's Rust code samples compile\")\n .arg_root_dir()\n .arg(\n Arg::new(\"chapter\")\n .short('c')\n .long(\"chapter\")\n .value_name(\"chapter\"),\n )\n .arg(\n Arg::new(\"library-path\")\n .short('L')\n .long(\"library-path\")\n .value_name(\"dir\")\n .value_delimiter(',')\n .value_parser(NonEmptyStringValueParser::new())\n .action(ArgAction::Append)\n .help(\n \"A comma-separated list of directories to add to the crate \\\n search path when building tests\",\n ),\n )\n}\n\n// test command implementation\npub fn execute(args: &ArgMatches) -> Result<()> {\n let library_paths: Vec<&str> = args\n .get_many(\"library-path\")\n .map(|it| it.map(String::as_str).collect())\n .unwrap_or_default();\n\n let chapter: Option<&str> = args.get_one::<String>(\"chapter\").map(|s| s.as_str());\n\n let book_dir = get_book_dir(args);\n let mut book = MDBook::load(book_dir)?;\n\n match chapter {\n Some(_) => book.test_chapter(library_paths, chapter),\n None => book.test(library_paths),\n }?;\n\n Ok(())\n}\n" }, { "path": "src/cmd/watch/native.rs", "content": "//! A filesystem watcher using native operating system facilities.\n\nuse ignore::gitignore::Gitignore;\nuse mdbook_driver::MDBook;\nuse std::path::{Path, PathBuf};\nuse std::sync::mpsc::channel;\nuse std::thread::sleep;\nuse std::time::Duration;\nuse tracing::{error, info, warn};\n\npub fn rebuild_on_change(\n book_dir: &Path,\n update_config: &dyn Fn(&mut MDBook),\n post_build: &dyn Fn(),\n) {\n use notify::RecursiveMode::*;\n\n let mut book = MDBook::load(book_dir).unwrap_or_else(|e| {\n error!(\"failed to load book: {e}\");\n std::process::exit(1);\n });\n\n // Create a channel to receive the events.\n let (tx, rx) = channel();\n\n let mut debouncer = match notify_debouncer_mini::new_debouncer(Duration::from_secs(1), tx) {\n Ok(d) => d,\n Err(e) => {\n error!(\"Error while trying to watch the files:\\n\\n\\t{:?}\", e);\n std::process::exit(1)\n }\n };\n let watcher = debouncer.watcher();\n\n // Add the source directory to the watcher\n if let Err(e) = watcher.watch(&book.source_dir(), Recursive) {\n error!(\"Error while watching {:?}:\\n {:?}\", book.source_dir(), e);\n std::process::exit(1);\n };\n\n let _ = watcher.watch(&book.theme_dir(), Recursive);\n\n // Add the book.toml file to the watcher if it exists\n let _ = watcher.watch(&book.root.join(\"book.toml\"), NonRecursive);\n\n for dir in &book.config.build.extra_watch_dirs {\n let path = book.root.join(dir);\n let canonical_path = path.canonicalize().unwrap_or_else(|e| {\n error!(\"Error while watching extra directory {path:?}:\\n {e}\");\n std::process::exit(1);\n });\n\n if let Err(e) = watcher.watch(&canonical_path, Recursive) {\n error!(\n \"Error while watching extra directory {:?}:\\n {:?}\",\n canonical_path, e\n );\n std::process::exit(1);\n }\n }\n\n info!(\"Listening for changes...\");\n\n loop {\n let first_event = rx.recv().unwrap();\n sleep(Duration::from_millis(50));\n let other_events = rx.try_iter();\n\n let all_events = std::iter::once(first_event).chain(other_events);\n\n let paths: Vec<_> = all_events\n .filter_map(|event| match event {\n Ok(events) => Some(events),\n Err(error) => {\n warn!(\"error while watching for changes: {error}\");\n None\n }\n })\n .flatten()\n .map(|event| event.path)\n .collect();\n\n // If we are watching files outside the current repository (via extra-watch-dirs), then they are definitionally\n // ignored by gitignore. So we handle this case by including such files into the watched paths list.\n let any_external_paths = paths.iter().filter(|p| !p.starts_with(&book.root)).cloned();\n let mut paths = remove_ignored_files(&book.root, &paths[..]);\n paths.extend(any_external_paths);\n\n if !paths.is_empty() {\n info!(\"Files changed: {paths:?}\");\n match MDBook::load(book_dir) {\n Ok(mut b) => {\n update_config(&mut b);\n if let Err(e) = b.build() {\n error!(\"failed to build the book: {e:?}\");\n } else {\n post_build();\n }\n book = b;\n }\n Err(e) => error!(\"failed to load book config: {e:?}\"),\n }\n }\n }\n}\n\nfn remove_ignored_files(book_root: &Path, paths: &[PathBuf]) -> Vec<PathBuf> {\n if paths.is_empty() {\n return vec![];\n }\n\n match super::find_gitignore(book_root) {\n Some(gitignore_path) => {\n let (ignore, err) = Gitignore::new(&gitignore_path);\n if let Some(err) = err {\n warn!(\n \"error reading gitignore `{}`: {err}\",\n gitignore_path.display()\n );\n }\n filter_ignored_files(ignore, paths)\n }\n None => {\n // There is no .gitignore file.\n paths.iter().map(|path| path.to_path_buf()).collect()\n }\n }\n}\n\n// Note: The usage of `canonicalize` may encounter occasional failures on the Windows platform, presenting a potential risk.\n// For more details, refer to [Pull Request #2229](https://github.com/rust-lang/mdBook/pull/2229#discussion_r1408665981).\nfn filter_ignored_files(ignore: Gitignore, paths: &[PathBuf]) -> Vec<PathBuf> {\n let ignore_root = ignore\n .path()\n .canonicalize()\n .expect(\"ignore root canonicalize error\");\n\n paths\n .iter()\n .filter(|path| {\n let relative_path = pathdiff::diff_paths(&path, &ignore_root)\n .expect(\"One of the paths should be an absolute\");\n !ignore\n .matched_path_or_any_parents(&relative_path, relative_path.is_dir())\n .is_ignore()\n })\n .map(|path| path.to_path_buf())\n .collect()\n}\n\n#[cfg(test)]\nmod tests {\n use super::*;\n use ignore::gitignore::GitignoreBuilder;\n use std::env;\n\n #[test]\n fn test_filter_ignored_files() {\n let current_dir = env::current_dir().unwrap();\n\n let ignore = GitignoreBuilder::new(¤t_dir)\n .add_line(None, \"*.html\")\n .unwrap()\n .build()\n .unwrap();\n let should_remain = current_dir.join(\"record.text\");\n let should_filter = current_dir.join(\"index.html\");\n\n let remain = filter_ignored_files(ignore, &[should_remain.clone(), should_filter]);\n assert_eq!(remain, vec![should_remain])\n }\n\n #[test]\n fn filter_ignored_files_should_handle_parent_dir() {\n let current_dir = env::current_dir().unwrap();\n\n let ignore = GitignoreBuilder::new(¤t_dir)\n .add_line(None, \"*.html\")\n .unwrap()\n .build()\n .unwrap();\n\n let parent_dir = current_dir.join(\"..\");\n let should_remain = parent_dir.join(\"record.text\");\n let should_filter = parent_dir.join(\"index.html\");\n\n let remain = filter_ignored_files(ignore, &[should_remain.clone(), should_filter]);\n assert_eq!(remain, vec![should_remain])\n }\n}\n" }, { "path": "src/cmd/watch/poller.rs", "content": "//! A simple poll-based filesystem watcher.\n//!\n//! This exists because the native change notifications have historically had\n//! lots of problems. Various operating systems and different filesystems have\n//! had problems correctly reporting changes.\n\nuse ignore::gitignore::Gitignore;\nuse mdbook_driver::MDBook;\nuse pathdiff::diff_paths;\nuse std::collections::HashMap;\nuse std::fs::FileType;\nuse std::path::{Path, PathBuf};\nuse std::time::{Duration, Instant, SystemTime};\nuse tracing::{debug, error, info, trace, warn};\nuse walkdir::WalkDir;\n\n/// Calls the closure when a book source file is changed, blocking indefinitely.\npub fn rebuild_on_change(\n book_dir: &Path,\n update_config: &dyn Fn(&mut MDBook),\n post_build: &dyn Fn(),\n) {\n let mut book = MDBook::load(book_dir).unwrap_or_else(|e| {\n error!(\"failed to load book: {e}\");\n std::process::exit(1);\n });\n\n let mut watcher = Watcher::new(book_dir);\n\n info!(\"Watching for changes...\");\n // Scan once to initialize the starting point.\n watcher.set_roots(&book);\n watcher.scan();\n\n // Track average scan time, to help investigate if the poller is taking\n // undesirably long. This is not a rigorous benchmark, just a rough\n // estimate.\n const AVG_SIZE: usize = 60;\n let mut avgs = vec![0.0; AVG_SIZE];\n let mut avg_i = 0;\n\n loop {\n std::thread::sleep(Duration::new(1, 0));\n let start = Instant::now();\n let paths = watcher.scan();\n let elapsed = start.elapsed().as_secs_f64();\n avgs[avg_i] = elapsed;\n avg_i += 1;\n if avg_i >= AVG_SIZE {\n avg_i = 0;\n let avg = avgs.iter().sum::<f64>() / (avgs.len() as f64);\n trace!(\n \"scan average time: {avg:.2}s, scan size is {}\",\n watcher.path_data.len()\n );\n }\n\n if !paths.is_empty() {\n info!(\"Files changed: {paths:?}\");\n match MDBook::load(book_dir) {\n Ok(mut b) => {\n update_config(&mut b);\n if let Err(e) = b.build() {\n error!(\"failed to build the book: {e:?}\");\n } else {\n post_build();\n }\n book = b;\n watcher.set_roots(&book);\n }\n Err(e) => error!(\"failed to load book config: {e:?}\"),\n }\n }\n }\n}\n\n#[derive(PartialEq)]\nstruct PathData {\n file_type: FileType,\n mtime: SystemTime,\n size: u64,\n}\n\n/// A very simple poll-watcher that scans for modified files.\n#[derive(Default)]\nstruct Watcher {\n /// The root paths where it will recursively scan for changes.\n root_paths: Vec<PathBuf>,\n /// Data about files on disk.\n path_data: HashMap<PathBuf, PathData>,\n /// Filters paths that will be watched.\n ignore: Option<(PathBuf, Gitignore)>,\n}\n\nimpl Watcher {\n fn new(book_root: &Path) -> Watcher {\n // FIXME: ignore should be reloaded when it changes.\n let ignore = super::find_gitignore(book_root).map(|gitignore_path| {\n let (ignore, err) = Gitignore::new(&gitignore_path);\n if let Some(err) = err {\n warn!(\n \"error reading gitignore `{}`: {err}\",\n gitignore_path.display()\n );\n }\n // Note: The usage of `canonicalize` may encounter occasional\n // failures on the Windows platform, presenting a potential risk.\n // For more details, refer to [Pull Request\n // #2229](https://github.com/rust-lang/mdBook/pull/2229#discussion_r1408665981).\n let ignore_path = ignore\n .path()\n .canonicalize()\n .expect(\"ignore root canonicalize error\");\n (ignore_path, ignore)\n });\n\n Watcher {\n ignore,\n ..Default::default()\n }\n }\n\n /// Sets the root directories where scanning will start.\n fn set_roots(&mut self, book: &MDBook) {\n let mut root_paths = vec![\n book.source_dir(),\n book.theme_dir(),\n book.root.join(\"book.toml\"),\n ];\n root_paths.extend(\n book.config\n .build\n .extra_watch_dirs\n .iter()\n .map(|path| book.root.join(path)),\n );\n if let Some(html_config) = book.config.html_config() {\n root_paths.extend(\n html_config\n .additional_css\n .iter()\n .chain(html_config.additional_js.iter())\n .map(|path| book.root.join(path)),\n );\n }\n\n self.root_paths = root_paths;\n }\n\n /// Scans for changes.\n ///\n /// Returns the paths that have changed.\n fn scan(&mut self) -> Vec<PathBuf> {\n let ignore = &self.ignore;\n let new_path_data: HashMap<_, _> = self\n .root_paths\n .iter()\n .filter(|root| root.exists())\n .flat_map(|root| {\n WalkDir::new(root)\n .follow_links(true)\n .into_iter()\n .filter_entry(|entry| {\n if let Some((ignore_path, ignore)) = ignore {\n let path = entry.path();\n // Canonicalization helps with removing `..` and\n // `.` entries, which can cause issues with\n // diff_paths.\n let path = path.canonicalize().unwrap_or_else(|_| path.to_path_buf());\n let relative_path = diff_paths(&path, &ignore_path)\n .expect(\"One of the paths should be an absolute\");\n if ignore\n .matched_path_or_any_parents(&relative_path, relative_path.is_dir())\n .is_ignore()\n {\n trace!(\"ignoring {path:?}\");\n return false;\n }\n }\n true\n })\n .filter_map(move |entry| {\n let entry = match entry {\n Ok(e) => e,\n Err(e) => {\n debug!(\"failed to scan {root:?}: {e}\");\n return None;\n }\n };\n if entry.file_type().is_dir() {\n // Changes to directories themselves aren't\n // particularly interesting.\n return None;\n }\n let path = entry.path().to_path_buf();\n\n let meta = match entry.metadata() {\n Ok(meta) => meta,\n Err(e) => {\n debug!(\"failed to scan {path:?}: {e}\");\n return None;\n }\n };\n let mtime = meta.modified().unwrap_or(SystemTime::UNIX_EPOCH);\n let pd = PathData {\n file_type: meta.file_type(),\n mtime,\n size: meta.len(),\n };\n Some((path, pd))\n })\n })\n .collect();\n let mut paths = Vec::new();\n for (new_path, new_data) in &new_path_data {\n match self.path_data.get(new_path) {\n Some(old_data) => {\n if new_data != old_data {\n paths.push(new_path.to_path_buf());\n }\n }\n None => {\n paths.push(new_path.clone());\n }\n }\n }\n for old_path in self.path_data.keys() {\n if !new_path_data.contains_key(old_path) {\n paths.push(old_path.to_path_buf());\n }\n }\n self.path_data = new_path_data;\n paths\n }\n}\n\n#[cfg(test)]\nmod tests {\n use super::*;\n\n /// Helper for testing the watcher.\n fn check_watch_behavior(\n gitignore_path: &str,\n gitignore: &str,\n book_root_path: &str,\n ignored: &[&str],\n not_ignored: &[&str],\n extra_setup: &dyn Fn(&Path),\n ) {\n // Create the book and initialize things.\n let temp = tempfile::Builder::new()\n .prefix(\"mdbook-\")\n .tempdir()\n .unwrap();\n let root = temp.path();\n let book_root = root.join(book_root_path);\n // eprintln!(\"book_root={book_root:?}\",);\n MDBook::init(&book_root).build().unwrap();\n std::fs::write(root.join(gitignore_path), gitignore).unwrap();\n let create = |paths: &[&str]| {\n let mut paths = paths\n .iter()\n .map(|path| root.join(path))\n .inspect(|path| {\n std::fs::create_dir_all(path.parent().unwrap()).unwrap();\n std::fs::write(path, \"initial content\").unwrap();\n })\n .map(|path| path.canonicalize().unwrap())\n .collect::<Vec<_>>();\n paths.sort();\n paths\n };\n let ignored = create(ignored);\n let not_ignored = create(not_ignored);\n extra_setup(&book_root);\n // Create a watcher and check its behavior.\n let book = MDBook::load(&book_root).unwrap();\n let mut watcher = Watcher::new(&book_root);\n watcher.set_roots(&book);\n // Do an initial scan to initialize its state.\n watcher.scan();\n // Verify the steady state is empty.\n let changed = watcher.scan();\n assert_eq!(changed, Vec::<PathBuf>::new());\n // Modify all files, and verify that only not_ignored are detected.\n for path in ignored.iter().chain(not_ignored.iter()) {\n std::fs::write(path, \"modified\").unwrap();\n }\n let changed = watcher.scan();\n let mut changed = changed\n .into_iter()\n .map(|p| p.canonicalize().unwrap())\n .collect::<Vec<_>>();\n changed.sort();\n assert_eq!(changed, not_ignored);\n // Verify again that steady state is empty.\n let changed = watcher.scan();\n assert_eq!(changed, Vec::<PathBuf>::new());\n }\n\n #[test]\n fn test_ignore() {\n // Basic gitignore test.\n check_watch_behavior(\n \"foo/.gitignore\",\n \"*.tmp\",\n \"foo\",\n &[\"foo/src/somefile.tmp\"],\n &[\"foo/src/chapter.md\"],\n &|_book_root| {},\n );\n }\n\n #[test]\n fn test_ignore_in_parent() {\n // gitignore is in the parent of the book\n check_watch_behavior(\n \".gitignore\",\n \"*.tmp\\nsomedir/\\n/inroot\\n/foo/src/inbook\\n\",\n \"foo\",\n &[\n \"foo/src/somefile.tmp\",\n \"foo/src/somedir/somefile\",\n \"inroot/somefile\",\n \"foo/src/inbook/somefile\",\n ],\n &[\"foo/src/inroot/somefile\"],\n &|_book_root| {},\n );\n }\n\n #[test]\n fn test_ignore_canonical() {\n // test with path with ..\n check_watch_behavior(\n \".gitignore\",\n \"*.tmp\\nsomedir/\\n/foo/src/inbook\\n\",\n \"bar/../foo\",\n &[\n \"foo/src/somefile.tmp\",\n \"foo/src/somedir/somefile\",\n \"foo/src/inbook/somefile\",\n ],\n &[\"foo/src/chapter.md\"],\n &|_book_root| {},\n );\n }\n\n #[test]\n fn test_scan_extra_watch() {\n // Check behavior with extra-watch-dirs\n check_watch_behavior(\n \".gitignore\",\n \"*.tmp\\n/outside-root/ignoreme\\n/foo/examples/ignoreme\\n\",\n \"foo\",\n &[\n \"foo/src/somefile.tmp\",\n \"foo/examples/example.tmp\",\n \"outside-root/somefile.tmp\",\n \"outside-root/ignoreme\",\n \"foo/examples/ignoreme\",\n ],\n &[\n \"foo/src/chapter.md\",\n \"foo/examples/example.rs\",\n \"foo/examples/example2.rs\",\n \"outside-root/image.png\",\n ],\n &|book_root| {\n std::fs::write(\n book_root.join(\"book.toml\"),\n r#\"\n [book]\n title = \"foo\"\n\n [build]\n extra-watch-dirs = [\n \"examples\",\n \"../outside-root\",\n ]\n \"#,\n )\n .unwrap();\n },\n );\n }\n}\n" }, { "path": "src/cmd/watch.rs", "content": "use super::command_prelude::*;\nuse crate::{get_book_dir, open};\nuse anyhow::Result;\nuse mdbook_driver::MDBook;\nuse std::path::{Path, PathBuf};\nuse tracing::error;\n\nmod native;\nmod poller;\n\n// Create clap subcommand arguments\npub fn make_subcommand() -> Command {\n Command::new(\"watch\")\n .about(\"Watches a book's files and rebuilds it on changes\")\n .arg_dest_dir()\n .arg_root_dir()\n .arg_open()\n .arg_watcher()\n}\n\npub enum WatcherKind {\n Poll,\n Native,\n}\n\nimpl WatcherKind {\n pub fn from_str(s: &str) -> WatcherKind {\n match s {\n \"poll\" => WatcherKind::Poll,\n \"native\" => WatcherKind::Native,\n _ => panic!(\"unsupported watcher {s}\"),\n }\n }\n}\n\n// Watch command implementation\npub fn execute(args: &ArgMatches) -> Result<()> {\n let book_dir = get_book_dir(args);\n let mut book = MDBook::load(&book_dir)?;\n\n let update_config = |book: &mut MDBook| {\n set_dest_dir(args, book);\n };\n update_config(&mut book);\n\n if args.get_flag(\"open\") {\n book.build()?;\n let path = book.build_dir_for(\"html\").join(\"index.html\");\n if !path.exists() {\n error!(\"No chapter available to open\");\n std::process::exit(1)\n }\n open(path);\n }\n\n let watcher = WatcherKind::from_str(args.get_one::<String>(\"watcher\").unwrap());\n rebuild_on_change(watcher, &book_dir, &update_config, &|| {});\n\n Ok(())\n}\n\npub fn rebuild_on_change(\n kind: WatcherKind,\n book_dir: &Path,\n update_config: &dyn Fn(&mut MDBook),\n post_build: &dyn Fn(),\n) {\n match kind {\n WatcherKind::Poll => self::poller::rebuild_on_change(book_dir, update_config, post_build),\n WatcherKind::Native => self::native::rebuild_on_change(book_dir, update_config, post_build),\n }\n}\n\nfn find_gitignore(book_root: &Path) -> Option<PathBuf> {\n book_root\n .ancestors()\n .map(|p| p.join(\".gitignore\"))\n .find(|p| p.exists())\n}\n" }, { "path": "src/main.rs", "content": "//! The mdbook CLI.\n\n#![allow(unreachable_pub, reason = \"not needed in a bin crate\")]\n\nuse anyhow::anyhow;\nuse clap::{Arg, ArgMatches, Command};\nuse clap_complete::Shell;\nuse mdbook_core::utils;\nuse std::env;\nuse std::ffi::OsStr;\nuse std::path::PathBuf;\nuse tracing::{error, info};\n\nmod cmd;\n\nconst VERSION: &str = concat!(\"v\", clap::crate_version!());\n\nfn main() {\n init_logger();\n\n let command = create_clap_command();\n\n // Check which subcommand the user ran...\n let res = match command.get_matches().subcommand() {\n Some((\"init\", sub_matches)) => cmd::init::execute(sub_matches),\n Some((\"build\", sub_matches)) => cmd::build::execute(sub_matches),\n Some((\"clean\", sub_matches)) => cmd::clean::execute(sub_matches),\n #[cfg(feature = \"watch\")]\n Some((\"watch\", sub_matches)) => cmd::watch::execute(sub_matches),\n #[cfg(feature = \"serve\")]\n Some((\"serve\", sub_matches)) => cmd::serve::execute(sub_matches),\n Some((\"test\", sub_matches)) => cmd::test::execute(sub_matches),\n Some((\"completions\", sub_matches)) => (|| {\n let shell = sub_matches\n .get_one::<Shell>(\"shell\")\n .ok_or_else(|| anyhow!(\"Shell name missing.\"))?;\n\n let mut complete_app = create_clap_command();\n clap_complete::generate(\n *shell,\n &mut complete_app,\n \"mdbook\",\n &mut std::io::stdout().lock(),\n );\n Ok(())\n })(),\n _ => unreachable!(),\n };\n\n if let Err(e) = res {\n utils::log_backtrace(&e);\n\n std::process::exit(101);\n }\n}\n\n/// Create a list of valid arguments and sub-commands\nfn create_clap_command() -> Command {\n let app = Command::new(clap::crate_name!())\n .about(clap::crate_description!())\n .author(\"Mathieu David <mathieudavid@mathieudavid.org>\")\n .version(VERSION)\n .propagate_version(true)\n .arg_required_else_help(true)\n .after_help(\n \"For more information about a specific command, try `mdbook <command> --help`\\n\\\n The source code for mdBook is available at: https://github.com/rust-lang/mdBook\",\n )\n .subcommand(cmd::init::make_subcommand())\n .subcommand(cmd::build::make_subcommand())\n .subcommand(cmd::test::make_subcommand())\n .subcommand(cmd::clean::make_subcommand())\n .subcommand(\n Command::new(\"completions\")\n .about(\"Generate shell completions for your shell to stdout\")\n .arg(\n Arg::new(\"shell\")\n .value_parser(clap::value_parser!(Shell))\n .help(\"the shell to generate completions for\")\n .value_name(\"SHELL\")\n .required(true),\n ),\n );\n\n #[cfg(feature = \"watch\")]\n let app = app.subcommand(cmd::watch::make_subcommand());\n #[cfg(feature = \"serve\")]\n let app = app.subcommand(cmd::serve::make_subcommand());\n\n app\n}\n\nfn init_logger() {\n let filter = tracing_subscriber::EnvFilter::builder()\n .with_env_var(\"MDBOOK_LOG\")\n .with_default_directive(tracing_subscriber::filter::LevelFilter::INFO.into())\n .from_env_lossy();\n let log_env = std::env::var(\"MDBOOK_LOG\");\n // Silence some particularly noisy dependencies unless the user\n // specifically asks for them.\n let silence_unless_specified = |filter: tracing_subscriber::EnvFilter, target| {\n if !log_env.as_ref().map_or(false, |s| {\n s.split(',').any(|directive| directive.starts_with(target))\n }) {\n filter.add_directive(format!(\"{target}=warn\").parse().unwrap())\n } else {\n filter\n }\n };\n let filter = silence_unless_specified(filter, \"handlebars\");\n let filter = silence_unless_specified(filter, \"html5ever\");\n\n // Don't show the target by default, since it generally isn't useful\n // unless you are overriding the level.\n let with_target = log_env.is_ok();\n\n tracing_subscriber::fmt()\n .without_time()\n .with_ansi(std::io::IsTerminal::is_terminal(&std::io::stderr()))\n .with_writer(std::io::stderr)\n .with_env_filter(filter)\n .with_target(with_target)\n .init();\n}\n\nfn get_book_dir(args: &ArgMatches) -> PathBuf {\n if let Some(p) = args.get_one::<PathBuf>(\"dir\") {\n // Check if path is relative from current dir, or absolute...\n if p.is_relative() {\n env::current_dir().unwrap().join(p)\n } else {\n p.to_path_buf()\n }\n } else {\n env::current_dir().expect(\"Unable to determine the current directory\")\n }\n}\n\nfn open<P: AsRef<OsStr>>(path: P) {\n info!(\"Opening web browser\");\n if let Err(e) = opener::open(path) {\n error!(\"Error opening web browser: {}\", e);\n }\n}\n\n#[test]\nfn verify_app() {\n create_clap_command().debug_assert();\n}\n" }, { "path": "tests/gui/books/all-summary/README.md", "content": "# All summary\n\nThis GUI test book tests all the different kinds of book items in the summary.\n" }, { "path": "tests/gui/books/all-summary/book.toml", "content": "[book]\ntitle = \"all-summary\"\n" }, { "path": "tests/gui/books/all-summary/src/SUMMARY.md", "content": "# Summary\n\n[Prefix 1](prefix-1.md)\n[Prefix 2](prefix-2.md)\n\n- [Introduction](intro.md)\n- [Draft]()\n\n# Part 1\n\n- [P1 C1](part-1/chapter-1.md)\n\n---\n\n# Part 2\n\n- [P2 C1](part-2/chapter-1.md)\n\n[Suffix 1](suffix-1.md)\n[Suffix 2](suffix-2.md)\n" }, { "path": "tests/gui/books/all-summary/src/intro.md", "content": "# Introduction\n" }, { "path": "tests/gui/books/all-summary/src/part-1/chapter-1.md", "content": "# P1 C1\n" }, { "path": "tests/gui/books/all-summary/src/part-2/chapter-1.md", "content": "# P2 C1\n" }, { "path": "tests/gui/books/all-summary/src/prefix-1.md", "content": "# Prefix 1\n" }, { "path": "tests/gui/books/all-summary/src/prefix-2.md", "content": "# Prefix 2\n" }, { "path": "tests/gui/books/all-summary/src/suffix-1.md", "content": "# Suffix 1\n" }, { "path": "tests/gui/books/all-summary/src/suffix-2.md", "content": "# Suffix 2\n" }, { "path": "tests/gui/books/basic/book.toml", "content": "[book]\ntitle = \"basic\"\n" }, { "path": "tests/gui/books/basic/src/SUMMARY.md", "content": "# Summary\n\n- [Chapter 1](./chapter_1.md)\n" }, { "path": "tests/gui/books/basic/src/chapter_1.md", "content": "# Chapter 1\n" }, { "path": "tests/gui/books/heading-nav/README.md", "content": "# Heading nav\n\nThis GUI test book is used for testing sidebar heading navigation.\n" }, { "path": "tests/gui/books/heading-nav/book.toml", "content": "[book]\ntitle = \"heading-nav\"\n" }, { "path": "tests/gui/books/heading-nav/src/SUMMARY.md", "content": "# Summary\n\n- [Empty page](empty.md)\n- [Large text before first heading](large-intro.md)\n- [Normal text before first heading](normal-intro.md)\n- [Collapsed headings](collapsed.md)\n- [Headings with markup](markup.md)\n- [Current scrolls to bottom](current-to-bottom.md)\n- [Unusual heading levels](unusual-heading-levels.md)\n- [Filtered headings](filtered-headings.md)\n" }, { "path": "tests/gui/books/heading-nav/src/collapsed.md", "content": "# Collapsed headings\n\nTests collapsed headings.\n\n## Heading 1\n\n1\\\n2\\\n3\\\n4\\\n5\n\n### Heading 1.1\n\n1\\\n2\\\n3\\\n4\\\n5\n\n### Heading 1.2\n\n1\\\n2\\\n3\\\n4\\\n5\n\n#### Heading 1.2.1\n\n1\\\n2\\\n3\\\n4\\\n5\n\n#### Heading 1.2.2\n\n1\\\n2\\\n3\\\n4\\\n5\n\n### Heading 1.3\n\n1\\\n2\\\n3\\\n4\\\n5\n\n## Heading 2\n\n1\\\n2\\\n3\\\n4\\\n5\n\n### Heading 2.1\n\n1\\\n2\\\n3\\\n4\\\n5\n\n#### Heading 2.1.1\n\n1\\\n2\\\n3\\\n4\\\n5\n\n##### Heading 2.1.1.1\n\n1\\\n2\\\n3\\\n4\\\n5\n\n###### Heading 2.1.1.1.1\n\n1\\\n2\\\n3\\\n4\\\n5\n" }, { "path": "tests/gui/books/heading-nav/src/current-to-bottom.md", "content": "# Current scrolls to bottom\n\nChecks that the \"current\" header works even when there are headers near the bottom.\n\n## First header\n\n<span id=\"scroll-to-1\">1</span>\\\n<span id=\"scroll-to-2\">2</span>\\\n<span id=\"scroll-to-3\">3</span>\\\n<span id=\"scroll-to-4\">4</span>\\\n<span id=\"scroll-to-5\">5</span>\\\n<span id=\"scroll-to-6\">6</span>\\\n<span id=\"scroll-to-7\">7</span>\\\n<span id=\"scroll-to-8\">8</span>\\\n<span id=\"scroll-to-9\">9</span>\\\n<span id=\"scroll-to-10\">10</span>\\\n<span id=\"scroll-to-11\">11</span>\\\n<span id=\"scroll-to-12\">12</span>\\\n<span id=\"scroll-to-13\">13</span>\\\n<span id=\"scroll-to-14\">14</span>\\\n<span id=\"scroll-to-15\">15</span>\\\n<span id=\"scroll-to-16\">16</span>\\\n<span id=\"scroll-to-17\">17</span>\\\n<span id=\"scroll-to-18\">18</span>\\\n<span id=\"scroll-to-19\">19</span>\\\n<span id=\"scroll-to-20\">20</span>\n\n## Second header\n\n<span id=\"scroll-to-21\">21</span>\n\n### Second sub-header\n\n<span id=\"scroll-to-22\">22</span>\n\n## Third header\n\n<span id=\"scroll-to-23\">23</span>\n\n## Fourth header\n\n<span id=\"scroll-to-24\">24</span>\n\n## Fifth header\n\n<span id=\"scroll-to-25\">25</span>\n" }, { "path": "tests/gui/books/heading-nav/src/empty.md", "content": "# Empty page\n" }, { "path": "tests/gui/books/heading-nav/src/filtered-headings.md", "content": "# Filtered headings\n\n## Skateboard\n\nChecking for search marking.\n" }, { "path": "tests/gui/books/heading-nav/src/large-intro.md", "content": "# Large text before first heading\n\nThis tests what happens if there is a lot of text before the first header, which is off the bottom of the screen.\n\n1\n\n2\n\n3\n\n4\n\n5\n\n6\n\n7\n\n8\n\n9\n\n10\n\n11\n\n12\n\n13\n\n14\n\n15\n\n16\n\n17\n\n18\n\n19\n\n20\n\n## First header\n\nText for first header.\n" }, { "path": "tests/gui/books/heading-nav/src/markup.md", "content": "# Headings with markup\n\nTests that heading markup gets copied to the sidebar.\n\n## Heading with `code` or *italic* or **bold** or ~~strike~~\n\nBasic markup should be copied.\n\n## Heading with a [link](../index.html)\n\nProbably not super-wise to have headings with links, but at least they shouldn't explode.\n\n## Heading with a custom id { #custom-id .custom-class }\n\nMake sure navigation works on a custom id.\n\n## Heading with <span>html</span>\n\nWhat happens if there is inline HTML?\n" }, { "path": "tests/gui/books/heading-nav/src/normal-intro.md", "content": "# Normal text before first heading\n\nThis test is to ensure the first heading shows up as \"current\" on page load.\n\n## The first heading\n\n1\n\n2\n\n3\n\n## The second heading\n\n### And a sub heading\n" }, { "path": "tests/gui/books/heading-nav/src/unusual-heading-levels.md", "content": "# Unusual heading levels\n\n### Heading 3\n\n## Heading 2\n\n#### Heading 5\n\n#### Heading 5.1\n" }, { "path": "tests/gui/books/heading-nav-folded/book.toml", "content": "[book]\ntitle = \"heading-nav-folded\"\n\n[output.html.fold]\nenable = true\nlevel = 0\n" }, { "path": "tests/gui/books/heading-nav-folded/src/SUMMARY.md", "content": "# Summary\n\n- [Introduction](./intro.md)\n - [Sub chapter](./sub/index.md)\n - [Sub inner](./sub/inner/index.md)\n - [Sub second chapter](./sub/second.md)\n- [Next main chapter](./next-main.md)\n" }, { "path": "tests/gui/books/heading-nav-folded/src/intro.md", "content": "# Introduction\n\n## Heading A\n\n### Heading A2\n\n### Heading A3\n\n## Heading B\n" }, { "path": "tests/gui/books/heading-nav-folded/src/next-main.md", "content": "# Next main chapter\n" }, { "path": "tests/gui/books/heading-nav-folded/src/sub/index.md", "content": "# Sub chapter\n\n## Sub-chapter heading\n" }, { "path": "tests/gui/books/heading-nav-folded/src/sub/inner/index.md", "content": "# Sub inner\n\n## Inner chapter heading\n" }, { "path": "tests/gui/books/heading-nav-folded/src/sub/second.md", "content": "# Sub second chapter\n\n## Second chapter heading\n" }, { "path": "tests/gui/books/highlighting/README.md", "content": "# Syntax Highlighting\n\nThis GUI test book is used for testing syntax highlighting.\n" }, { "path": "tests/gui/books/highlighting/book.toml", "content": "[book]\ntitle = \"Syntax Highlighting\"\n" }, { "path": "tests/gui/books/highlighting/src/SUMMARY.md", "content": "# Summary\n\n- [Languages](./languages.md)\n" }, { "path": "tests/gui/books/highlighting/src/languages.md", "content": "# Syntax Highlights\n\n## apache\n\n```apache\n# rewrite`s rules for wordpress pretty url\nLoadModule rewrite_module modules/mod_rewrite.so\nRewriteCond %{REQUEST_FILENAME} !-f\nRewriteCond %{REQUEST_FILENAME} !-d\nRewriteRule . index.php [NC,L]\n\nExpiresActive On\nExpiresByType application/x-javascript \"access plus 1 days\"\n\nOrder Deny,Allow\nAllow from All\n\n<Location /maps/>\n RewriteMap map txt:map.txt\n RewriteMap lower int:tolower\n RewriteCond %{REQUEST_URI} ^/([^/.]+)\\.html$ [NC]\n RewriteCond ${map:${lower:%1}|NOT_FOUND} !NOT_FOUND\n RewriteRule .? /index.php?q=${map:${lower:%1}} [NC,L]\n</Location>\n\n20.164.151.111 - - [20/Aug/2015:22:20:18 -0400] \"GET /mywebpage/index.php HTTP/1.1\" 403 772 \"-\" \"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_6_8) AppleWebKit/535.1 (KHTML, like Gecko) Chrome/13.0.782.220 Safari/535.1\"\n```\n\n## armasm\n\n```armasm\n.data\n\n/* Data segment: define our message string and calculate its length. */\nmsg:\n .ascii \"Hello, ARM!\\n\"\nlen = . - msg\n\n.text\n\n/* Our application's entry point. */\n.globl _start\n_start:\n /* syscall write(int fd, const void *buf, size_t count) */\n mov %r0, $1 /* fd := STDOUT_FILENO */\n ldr %r1, =msg /* buf := msg */\n ldr %r2, =len /* count := len */\n mov %r7, $4 /* write is syscall #4 */\n swi $0 /* invoke syscall */\n\n /* syscall exit(int status) */\n mov %r0, $0 /* status := 0 */\n mov %r7, $1 /* exit is syscall #1 */\n swi $0 /* invoke syscall */\n\n```\n\n## bash\n\n```bash\n#!/bin/bash\n\n###### CONFIG\nACCEPTED_HOSTS=\"/root/.hag_accepted.conf\"\nBE_VERBOSE=false\n\nif [ \"$UID\" -ne 0 ]\nthen\n echo \"Superuser rights required\"\n exit 2\nfi\n\ngenApacheConf(){\n echo -e \"# Host ${HOME_DIR}$1/$2 :\"\n}\n\necho '\"quoted\"' | tr -d \\\" > text.txt\n\n```\n\n## c\n\n```c\n#include <stdio.h>\nvoid main(int argc,char ** argv){\n printf(\"Hello World!\");\n}\n\n```\n\n## coffeescript\n\n```coffeescript\ngrade = (student, period=(if b? then 7 else 6)) ->\n if student.excellentWork\n \"A+\"\n else if student.okayStuff\n if student.triedHard then \"B\" else \"B-\"\n else\n \"C\"\n\nclass Animal extends Being\n constructor: (@name) ->\n\n move: (meters) ->\n alert @name + \" moved #{meters}m.\"\n```\n\n## cpp\n\n```cpp\n#include <iostream>\nusing namespace std;\nint main() {\n cout << \"Hello, World!\" << endl; // This prints Hello, World!\n return 0;\n}\n```\n\n## csharp\n\n```csharp\nusing System;\nclass App\n{\n static void Main()\n {\n Console.WriteLine(\"Hello World!\");\n }\n}\n```\n\n## css\n\n```css\n@font-face {\n font-family: Chunkfive;\n src: url('Chunkfive.otf');\n}\n\nbody,\n.usertext {\n color: #f0f0f0;\n background: #600;\n font-family: Chunkfive, sans;\n --heading-1: 30px/32px Helvetica, sans-serif;\n}\n\n@import url(print.css);\n@media print {\n a[href^='http']::after {\n content: attr(href);\n }\n}\n```\n\n## d\n\n```d\n/* This program prints a\n hello world message\n to the console. */\n\nimport std.stdio;\n\nvoid main()\n{\n writeln(\"Hello, World!\");\n}\n```\n\n## diff\n\n```diff\nIndex: languages/ini.js\n===================================================================\n--- languages/ini.js (revision 199)\n+++ languages/ini.js (revision 200)\n@@ -1,8 +1,7 @@\n hljs.LANGUAGES.ini =\n {\n case_insensitive: true,\n- defaultMode:\n- {\n+ defaultMode: {\n contains: ['comment', 'title', 'setting'],\n illegal: '[^\\\\s]'\n },\n\n*** /path/to/original timestamp\n--- /path/to/new timestamp\n***************\n*** 1,3 ****\n--- 1,9 ----\n+ This is an important\n+ notice! It should\n+ therefore be located at\n+ the beginning of this\n+ document!\n\n! compress the size of the\n! changes.\n\n It is important to spell\n```\n\n## go\n\n```go\npackage main\nimport \"fmt\"\n\nfunc main() {\n fmt.Println(\"Hello World!\")\n}\n```\n\n## handlebars\n\n```handlebars\n<div class='entry'>\n {{! only show if author exists }}\n {{#if author}}\n <h1>{{firstName}} {{lastName}}</h1>\n {{/if}}\n</div>\n```\n\n## haskell\n\n```haskell\nmain :: IO ()\nmain = putStrLn \"Hello World!\"\n\n```\n\n## http\n\n```http\nPOST /task?id=1 HTTP/1.1\nHost: example.org\nContent-Type: application/json; charset=utf-8\nContent-Length: 137\n\n{\n \"status\": \"ok\",\n \"extended\": true,\n \"results\": [\n {\"value\": 0, \"type\": \"int64\"},\n {\"value\": 1.0e+3, \"type\": \"decimal\"}\n ]\n}\n\n```\n\n## ini\n\n```ini\n; boilerplate\n[package]\nname = \"some_name\"\nauthors = [\"Author\"]\ndescription = \"This is \\\na description\"\n\n[[lib]]\nname = ${NAME}\ndefault = True\nauto = no\ncounter = 1_000\n```\n\n## java\n\n```java\nclass Main {\n public static void main(String[] args) {\n System.out.println(\"Hello World!\");\n }\n}\n```\n\n## javascript\n\n```javascript\nfunction $initHighlight(block, cls) {\n try {\n if (cls.search(/\\bno\\-highlight\\b/) != -1)\n return process(block, true, 0x0F) +\n ` class=\"${cls}\"`;\n } catch (e) {\n /* handle exception */\n }\n for (var i = 0 / 2; i < classes.length; i++) {\n if (checkCondition(classes[i]) === undefined)\n console.log('undefined');\n }\n\n return (\n <div>\n <web-component>{block}</web-component>\n </div>\n )\n}\n\nexport $initHighlight;\n```\n\n## json\n\n```json\n[\n {\n \"title\": \"apples\",\n \"count\": [12000, 20000],\n \"description\": { \"text\": \"...\", \"sensitive\": false }\n },\n {\n \"title\": \"oranges\",\n \"count\": [17500, null],\n \"description\": { \"text\": \"...\", \"sensitive\": false }\n }\n]\n```\n\n## julia\n\n```julia\n# function to calculate the volume of a sphere\nfunction sphere_vol(r)\n # julia allows Unicode names (in UTF-8 encoding)\n # so either \"pi\" or the symbol π can be used\n return 4/3*pi*r^3\nend\n\n# functions can also be defined more succinctly\nquadratic(a, sqr_term, b) = (-b + sqr_term) / 2a\n\n# calculates x for 0 = a*x^2+b*x+c, arguments types can be defined in function definitions\nfunction quadratic2(a::Float64, b::Float64, c::Float64)\n # unlike other languages 2a is equivalent to 2*a\n # a^2 is used instead of a**2 or pow(a,2)\n sqr_term = sqrt(b^2-4a*c)\n r1 = quadratic(a, sqr_term, b)\n r2 = quadratic(a, -sqr_term, b)\n # multiple values can be returned from a function using tuples\n # if the return keyword is omitted, the last term is returned\n r1, r2\nend\n\nvol = sphere_vol(3)\n```\n\n## kotlin\n\n```kotlin\npackage org.kotlinlang.play\n\nfun main() {\n println(\"Hello, World!\")\n}\n```\n\n## less\n\n```less\n@import 'fruits';\n\n@rhythm: 1.5em;\n\n@media screen and (min-resolution: 2dppx) {\n body {\n font-size: 125%;\n }\n}\n\nsection > .foo + #bar:hover [href*='less'] {\n margin: @rhythm 0 0 @rhythm;\n padding: calc(5% + 20px);\n background: #f00ba7 url(http://placehold.alpha-centauri/42.png) no-repeat;\n background-image: linear-gradient(-135deg, wheat, fuchsia) !important ;\n background-blend-mode: multiply;\n}\n\n@font-face {\n font-family: /* ? */ 'Omega';\n src: url('../fonts/omega-webfont.woff?v=2.0.2');\n}\n\n.icon-baz::before {\n display: inline-block;\n font-family: 'Omega', Alpha, sans-serif;\n content: '\\f085';\n color: rgba(98, 76 /* or 54 */, 231, 0.75);\n}\n```\n\n## lua\n\n```lua\n--[[\nSimple signal/slot implementation\n]]\nlocal signal_mt = {\n __index = {\n register = table.insert\n }\n}\nfunction signal_mt.__index:emit(... --[[ Comment in params ]])\n for _, slot in ipairs(self) do\n slot(self, ...)\n end\nend\nlocal function create_signal()\n return setmetatable({}, signal_mt)\nend\n\n-- Signal test\nlocal signal = create_signal()\nsignal:register(function(signal, ...)\n print(...)\nend)\nsignal:emit('Answer to Life, the Universe, and Everything:', 42)\n\n--[==[ [=[ [[\nNested ]]\nmulti-line ]=]\ncomment ]==]\n[==[ Nested\n[=[ multi-line\n[[ string\n]] ]=] ]==]\n```\n\n## makefile\n\n```makefile\n# Makefile\n\nBUILDDIR = _build\nEXTRAS ?= $(BUILDDIR)/extras\n\n.PHONY: main clean\n\nmain:\n\t@echo \"Building main facility...\"\n\tbuild_main $(BUILDDIR)\n\nclean:\n\trm -rf $(BUILDDIR)/*\n\n```\n\n## markdown\n\n```markdown\n# hello world\n\nyou can write text [with links](http://example.com) inline or [link references][1].\n\n- one _thing_ has *em*phasis\n- two **things** are **bold**\n\n[1]: http://example.com\n\n---\n\n# hello world\n\n<this_is inline=\"xml\"></this_is>\n\n> markdown is so cool\n\n so are code segments\n\n1. one thing (yeah!)\n2. two thing `i can write code`, and `more` wipee!\n```\n\n## nginx\n\n```nginx\nuser www www;\nworker_processes 2;\npid /var/run/nginx.pid;\nerror_log /var/log/nginx.error_log debug | info | notice | warn | error | crit;\n\nevents {\n connections 2000;\n use kqueue | rtsig | epoll | /dev/poll | select | poll;\n}\n\nhttp {\n log_format main '$remote_addr - $remote_user [$time_local] '\n '\"$request\" $status $bytes_sent '\n '\"$http_referer\" \"$http_user_agent\" '\n '\"$gzip_ratio\"';\n\n send_timeout 3m;\n client_header_buffer_size 1k;\n\n gzip on;\n gzip_min_length 1100;\n\n #lingering_time 30;\n\n server {\n server_name one.example.com www.one.example.com;\n access_log /var/log/nginx.access_log main;\n\n rewrite (.*) /index.php?page=$1 break;\n\n location / {\n proxy_pass http://127.0.0.1/;\n proxy_redirect off;\n proxy_set_header Host $host;\n proxy_set_header X-Real-IP $remote_addr;\n charset koi8-r;\n }\n\n location /api/ {\n fastcgi_pass 127.0.0.1:9000;\n }\n\n location ~* \\.(jpg|jpeg|gif)$ {\n root /spool/www;\n }\n }\n}\n```\n\n## nim\n\n```nim\nfrom strutils import `%`\n\nconst numDoors = 100\nvar doors {.compileTime.}: array[1..numDoors, bool]\n\nproc calcDoors(): string =\n for pass in 1..numDoors:\n for door in countup(pass, numDoors, pass):\n doors[door] = not doors[door]\n for door in 1..numDoors:\n result.add(\"Door $1 is $2.\\n\" % [$door, if doors[door]: \"open\" else: \"closed\"])\n\nconst outputString: string = calcDoors()\n\necho outputString\n```\n\n## objectivec\n\n```objectivec\n#import <Foundation/Foundation.h>\n\nint main(int argc, const char * argv[]) {\n @mylak {\n NSLog(@\"Hello World!\");\n }\n return 0;\n}\n\n```\n\n## nix\n\n```nix\nlet\n world = \"World!\";\nin\n\"Hello \" + world\n```\n\n## perl\n\n```perl\nprint \"Hello World!\\n\";\n```\n\n## php\n\n```php\n<?php\necho \"Hello World!\";\n?>\n```\n\n## plaintext\n\n```plaintext\nI think this is simply plain text?\nHello World!\n```\n\n## properties\n\n```properties\n# .properties\n! Exclamation mark = comments, too\n\nkey1 = value1\nkey2 : value2\nkey3 value3\nkey\\ spaces multiline\\\n value4\nempty_key\n! Key can contain escaped chars\n\\:\\= = value5\n```\n\n## python\n\n```python\n@requires_authorization(roles=[\"ADMIN\"])\ndef somefunc(param1='', param2=0):\n r'''A docstring'''\n if param1 > param2: # interesting\n print 'Gre\\'ater'\n return (param2 - param1 + 1 + 0b10l) or None\n\nclass SomeClass:\n pass\n\n>>> message = '''interpreter\n... prompt'''\n```\n\n## r\n\n```r\nrequire(stats)\n\n#' Compute different averages\n#'\n#' @param x \\code{numeric} vector of sample data\n#' @param type \\code{character} vector of length 1 specifying the average type\n#' @return \\code{centre} returns the sample average according to the chosen method.\n#' @examples\n#' centre(rcauchy(10), \"mean\")\n#' @export\ncentre <- function(x, type) {\n switch(type,\n mean = mean(x),\n median = median(x),\n trimmed = mean(x, trim = .1))\n}\nx <- rcauchy(10)\ncentre(x, \"mean\")\n\nlibrary(ggplot2)\n\nmodels <- tibble::tribble(\n ~model_name, ~ formula,\n \"length-width\", Sepal.Length ~ Petal.Width + Petal.Length,\n \"interaction\", Sepal.Length ~ Petal.Width * Petal.Length\n)\n\niris %>%\n nest_by(Species) %>%\n left_join(models, by = character()) %>%\n rowwise(Species, model_name) %>%\n mutate(model = list(lm(formula, data = data))) %>%\n summarise(broom::glance(model))\n```\n\n## ruby\n\n```ruby\n# The Greeter class\nclass Greeter\n def initialize(name)\n @name = name.capitalize\n end\n\n def salute\n puts \"Hello #{@name}!\"\n end\nend\n\ng = Greeter.new(\"world\")\ng.salute\n```\n\n## rust\n\n```rust\nfn main()->(){\n println!(\"Hello World!\");\n}\n```\n\n## scala\n\n```scala\n/**\n * A person has a name and an age.\n */\ncase class Person(name: String, age: Int)\n\nabstract class Vertical extends CaseJeu\ncase class Haut(a: Int) extends Vertical\ncase class Bas(name: String, b: Double) extends Vertical\n\nsealed trait Ior[+A, +B]\ncase class Left[A](a: A) extends Ior[A, Nothing]\ncase class Right[B](b: B) extends Ior[Nothing, B]\ncase class Both[A, B](a: A, b: B) extends Ior[A, B]\n\ntrait Functor[F[_]] {\n def map[A, B](fa: F[A], f: A => B): F[B]\n}\n\n// beware Int.MinValue\ndef absoluteValue(n: Int): Int =\n if (n < 0) -n else n\n\ndef interp(n: Int): String =\n s\"there are $n ${color} balloons.\\n\"\n\ntype ξ[A] = (A, A)\n\ntrait Hist { lhs =>\n def ⊕(rhs: Hist): Hist\n}\n\ndef gsum[A: Ring](as: Seq[A]): A =\n as.foldLeft(Ring[A].zero)(_ + _)\n\nval actions: List[Symbol] =\n 'init :: 'read :: 'write :: 'close :: Nil\n```\n\n## scss\n\n```scss\nimport \"compass/reset\";\n\n// variables\n$colorGreen: #008000;\n$colorGreenDark: darken($colorGreen, 10);\n\n@mixin container {\n max-width: 980px;\n}\n\n// mixins with parameters\n@mixin button($color:green) {\n @if ($color == green) {\n background-color: #008000;\n }\n @else if ($color == red) {\n background-color: #B22222;\n }\n}\n\nbutton {\n @include button(red);\n}\n\ndiv,\n.navbar,\n#header,\ninput[type=\"input\"] {\n font-family: \"Helvetica Neue\", Arial, sans-serif;\n width: auto;\n margin: 0 auto;\n display: block;\n}\n\n.row-12 > [class*=\"spans\"] {\n border-left: 1px solid #B5C583;\n}\n\n```\n\n## shell\n\n```shell\n$ echo $EDITOR\nvim\n$ git checkout main\nSwitched to branch 'main'\nYour branch is up-to-date with 'origin/main'.\n$ git push\nEverything up-to-date\n$ echo 'All\n> done!'\nAll\ndone!\n\n```\n\n## sql\n\n```sql\nCREATE TABLE \"topic\" (\n \"id\" integer NOT NULL PRIMARY KEY,\n \"forum_id\" integer NOT NULL,\n \"subject\" varchar(255) NOT NULL\n);\nALTER TABLE \"topic\"\nADD CONSTRAINT forum_id FOREIGN KEY (\"forum_id\")\nREFERENCES \"forum\" (\"id\");\n\n-- Initials\ninsert into \"topic\" (\"forum_id\", \"subject\")\nvalues (2, 'D''artagnian');\n```\n\n## swift\n\n```swift\nimport Foundation\n\n@objc class Person: Entity {\n var name: String!\n var age: Int!\n\n init(name: String, age: Int) {\n /* /* ... */ */\n }\n\n // Return a descriptive string for this person\n func description(offset: Int = 0) -> String {\n return \"\\(name) is \\(age + offset) years old\"\n }\n}\n```\n\n## typescript\n\n```typescript\nclass MyClass {\n public static myValue: string;\n constructor(init: string) {\n this.myValue = init;\n }\n}\nimport fs = require(\"fs\");\nmodule MyModule {\n export interface MyInterface extends Other {\n myProperty: any;\n }\n}\ndeclare magicNumber number;\nmyArray.forEach(() => { }); // fat arrow syntax\n\n```\n\n## x86asm\n\n```x86asm\nsection .text\nextern _MessageBoxA@16\n%if __NASM_VERSION_ID__ >= 0x02030000\nsafeseh handler ; register handler as \"safe handler\"\n%endif\n\nhandler:\n push dword 1 ; MB_OKCANCEL\n push dword caption\n push dword text\n push dword 0\n call _MessageBoxA@16\n sub eax,1 ; incidentally suits as return value\n ; for exception handler\n ret\n\nglobal _main\n_main: push dword handler\n push dword [fs:0]\n mov dword [fs:0], esp\n xor eax,eax\n mov eax, dword[eax] ; cause exception\n pop dword [fs:0] ; disengage exception handler\n add esp, 4\n ret\n\navx2: vzeroupper\n push rbx\n mov rbx, rsp\n sub rsp, 0h20\n vmovdqa ymm0, [rcx]\n vpaddb ymm0, [rdx]\n leave\n ret\n\ntext: db 'OK to rethrow, CANCEL to generate core dump',0\ncaption:db 'SEGV',0\n\nsection .drectve info\n db '/defaultlib:user32.lib /defaultlib:msvcrt.lib '\n```\n\n## xml\n\n```xml\n<!DOCTYPE html>\n<title>Title\n\n\n\n\n\n\n

Title

\n \n\n```\n\n## yaml\n\n```yaml\n---\n# comment\nstring_1: \"Bar\"\nstring_2: 'bar'\nstring_3: bar\ninline_keys_ignored: sompath/name/file.jpg\nkeywords_in_yaml:\n - true\n - false\n - TRUE\n - FALSE\n - 21\n - 21.0\n - !!str 123\n\"quoted_key\": &foobar\n bar: foo\n foo:\n \"foo\": bar\n\nreference: *foobar\n\nmultiline_1: |\n Multiline\n String\nmultiline_2: >\n Multiline\n String\nmultiline_3: \"\n Multiline string\n \"\n\nansible_variables: \"foo {{variable}}\"\n\narray_nested:\n- a\n- b: 1\n c: 2\n- b\n- comment\n```\n" }, { "path": "tests/gui/books/redirect/README.md", "content": "# Redirect\n\nThis GUI test book tests the redirect configuration.\n" }, { "path": "tests/gui/books/redirect/book.toml", "content": "[book]\ntitle = \"redirect\"\n\n[output.html.redirect]\n\"/inner/old.html\" = \"../new-chapter.html\"\n\n# This is a source without a fragment, and one with a fragment that goes to\n# the same place. The redirect with the fragment is not necessary, since that\n# is the default behavior.\n\"/pointless-fragment.html\" = \"new-chapter.html\"\n\"/pointless-fragment.html#foo\" = \"new-chapter.html#foo\"\n\n\"/rename-page-and-fragment.html\" = \"new-chapter.html\"\n\"/rename-page-and-fragment.html#orig\" = \"new-chapter.html#new\"\n\n\"/rename-page-fragment-elsewhere.html\" = \"new-chapter.html\"\n\"/rename-page-fragment-elsewhere.html#orig\" = \"other-chapter.html#new\"\n\n# Rename fragment on an existing page.\n\"/new-chapter.html#orig\" = \"new-chapter.html#new\"\n# Rename fragment on an existing page to another page.\n\"/new-chapter.html#orig-new-chapter\" = \"other-chapter.html#new\"\n\n\"/full-url-with-fragment.html\" = \"https://www.rust-lang.org/#fragment\"\n\n\"/full-url-with-fragment-map.html\" = \"https://www.rust-lang.org/\"\n\"/full-url-with-fragment-map.html#a\" = \"https://www.rust-lang.org/#new1\"\n\"/full-url-with-fragment-map.html#b\" = \"https://www.rust-lang.org/#new2\"\n" }, { "path": "tests/gui/books/redirect/src/SUMMARY.md", "content": "# Summary\n\n- [New chapter](new-chapter.md)\n- [Other chapter](other-chapter.md)\n" }, { "path": "tests/gui/books/redirect/src/chapter_1.md", "content": "# Chapter 1\n" }, { "path": "tests/gui/books/redirect/src/new-chapter.md", "content": "# New chapter\n" }, { "path": "tests/gui/books/redirect/src/other-chapter.md", "content": "# Other chapter\n" }, { "path": "tests/gui/books/search/README.md", "content": "# Search\n\nThis GUI test book is used for testing basic search interaction.\n" }, { "path": "tests/gui/books/search/book.toml", "content": "[book]\ntitle = \"search\"\n" }, { "path": "tests/gui/books/search/src/SUMMARY.md", "content": "# Summary\n\n- [Chapter 1](./chapter_1.md)\n- [Chapter 2](./inner/chapter_2.md)\n" }, { "path": "tests/gui/books/search/src/chapter_1.md", "content": "# Chapter 1\n\nextraordinary refrigerator philosophical thunderstorm kaleidoscope\n\n## Repeat on same page\n\nkaleidoscope\n" }, { "path": "tests/gui/books/search/src/inner/chapter_2.md", "content": "# Chapter 2\n\nchampionship mediterranean sophisticated tuberculosis photographer\n\n## Repeat from other chapter\n\nextraordinary\n" }, { "path": "tests/gui/books/sidebar-scroll/book.toml", "content": "[book]\ntitle = \"sidebar-scroll\"\nlanguage = \"en\"\n" }, { "path": "tests/gui/books/sidebar-scroll/src/SUMMARY.md", "content": "# Summary\n\n- [Chapter 1](./chapter_1.md)\n- [Chapter 2](./chapter_2.md)\n- [Chapter 3](./chapter_3.md)\n- [Chapter 4](./chapter_4.md)\n- [Chapter 5](./chapter_5.md)\n- [Chapter 6](./chapter_6.md)\n- [Chapter 7](./chapter_7.md)\n- [Chapter 8](./chapter_8.md)\n- [Chapter 9](./chapter_9.md)\n- [Chapter 10](./chapter_10.md)\n- [Chapter 11](./chapter_11.md)\n- [Chapter 12](./chapter_12.md)\n- [Chapter 13](./chapter_13.md)\n- [Chapter 14](./chapter_14.md)\n- [Chapter 15](./chapter_15.md)\n- [Chapter 16](./chapter_16.md)\n- [Chapter 17](./chapter_17.md)\n- [Chapter 18](./chapter_18.md)\n- [Chapter 19](./chapter_19.md)\n- [Chapter 20](./chapter_20.md)\n- [Chapter 21](./chapter_21.md)\n- [Chapter 22](./chapter_22.md)\n- [Chapter 23](./chapter_23.md)\n- [Chapter 24](./chapter_24.md)\n- [Chapter 25](./chapter_25.md)\n- [Chapter 26](./chapter_26.md)\n- [Chapter 27](./chapter_27.md)\n- [Chapter 28](./chapter_28.md)\n- [Chapter 29](./chapter_29.md)\n- [Chapter 30](./chapter_30.md)\n- [Chapter 31](./chapter_31.md)\n- [Chapter 32](./chapter_32.md)\n- [Chapter 33](./chapter_33.md)\n- [Chapter 34](./chapter_34.md)\n- [Chapter 35](./chapter_35.md)\n- [Chapter 36](./chapter_36.md)\n- [Chapter 37](./chapter_37.md)\n- [Chapter 38](./chapter_38.md)\n- [Chapter 39](./chapter_39.md)\n- [Chapter 40](./chapter_40.md)\n- [Chapter 41](./chapter_41.md)\n- [Chapter 42](./chapter_42.md)\n- [Chapter 43](./chapter_43.md)\n- [Chapter 44](./chapter_44.md)\n- [Chapter 45](./chapter_45.md)\n- [Chapter 46](./chapter_46.md)\n- [Chapter 47](./chapter_47.md)\n- [Chapter 48](./chapter_48.md)\n- [Chapter 49](./chapter_49.md)\n- [Chapter 50](./chapter_50.md)\n- [Chapter 51](./chapter_51.md)\n- [Chapter 52](./chapter_52.md)\n- [Chapter 53](./chapter_53.md)\n- [Chapter 54](./chapter_54.md)\n- [Chapter 55](./chapter_55.md)\n- [Chapter 56](./chapter_56.md)\n- [Chapter 57](./chapter_57.md)\n- [Chapter 58](./chapter_58.md)\n- [Chapter 59](./chapter_59.md)\n- [Chapter 60](./chapter_60.md)\n- [Chapter 61](./chapter_61.md)\n- [Chapter 62](./chapter_62.md)\n- [Chapter 63](./chapter_63.md)\n- [Chapter 64](./chapter_64.md)\n- [Chapter 65](./chapter_65.md)\n- [Chapter 66](./chapter_66.md)\n- [Chapter 67](./chapter_67.md)\n- [Chapter 68](./chapter_68.md)\n- [Chapter 69](./chapter_69.md)\n- [Chapter 70](./chapter_70.md)\n- [Chapter 71](./chapter_71.md)\n- [Chapter 72](./chapter_72.md)\n- [Chapter 73](./chapter_73.md)\n- [Chapter 74](./chapter_74.md)\n- [Chapter 75](./chapter_75.md)\n- [Chapter 76](./chapter_76.md)\n- [Chapter 77](./chapter_77.md)\n- [Chapter 78](./chapter_78.md)\n- [Chapter 79](./chapter_79.md)\n- [Chapter 80](./chapter_80.md)\n- [Chapter 81](./chapter_81.md)\n- [Chapter 82](./chapter_82.md)\n- [Chapter 83](./chapter_83.md)\n- [Chapter 84](./chapter_84.md)\n- [Chapter 85](./chapter_85.md)\n- [Chapter 86](./chapter_86.md)\n- [Chapter 87](./chapter_87.md)\n- [Chapter 88](./chapter_88.md)\n- [Chapter 89](./chapter_89.md)\n- [Chapter 90](./chapter_90.md)\n- [Chapter 91](./chapter_91.md)\n- [Chapter 92](./chapter_92.md)\n- [Chapter 93](./chapter_93.md)\n- [Chapter 94](./chapter_94.md)\n- [Chapter 95](./chapter_95.md)\n- [Chapter 96](./chapter_96.md)\n- [Chapter 97](./chapter_97.md)\n- [Chapter 98](./chapter_98.md)\n- [Chapter 99](./chapter_99.md)\n- [Chapter 100](./chapter_100.md)\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_1.md", "content": "# Chapter 1\n\n## This has a single heading\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_10.md", "content": "# Chapter 10\n\n## Heading A\n## Heading B\n## Heading C\n## Heading D\n## Heading E\n## Heading F\n## Heading G\n## Heading H\n## Heading I\n## Heading J\n## Heading K\n## Heading L\n## Heading M\n## Heading N\n## Heading O\n## Heading P\n## Heading Q\n## Heading R\n## Heading S\n## Heading T\n## Heading U\n## Heading V\n## Heading W\n## Heading X\n## Heading Y\n## Heading Z\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_100.md", "content": "# Chapter 100\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_11.md", "content": "# Chapter 11\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_12.md", "content": "# Chapter 12\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_13.md", "content": "# Chapter 13\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_14.md", "content": "# Chapter 14\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_15.md", "content": "# Chapter 15\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_16.md", "content": "# Chapter 16\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_17.md", "content": "# Chapter 17\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_18.md", "content": "# Chapter 18\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_19.md", "content": "# Chapter 19\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_2.md", "content": "# Chapter 2\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_20.md", "content": "# Chapter 20\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_21.md", "content": "# Chapter 21\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_22.md", "content": "# Chapter 22\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_23.md", "content": "# Chapter 23\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_24.md", "content": "# Chapter 24\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_25.md", "content": "# Chapter 25\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_26.md", "content": "# Chapter 26\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_27.md", "content": "# Chapter 27\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_28.md", "content": "# Chapter 28\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_29.md", "content": "# Chapter 29\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_3.md", "content": "# Chapter 3\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_30.md", "content": "# Chapter 30\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_31.md", "content": "# Chapter 31\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_32.md", "content": "# Chapter 32\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_33.md", "content": "# Chapter 33\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_34.md", "content": "# Chapter 34\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_35.md", "content": "# Chapter 35\n\n## Heading A\n## Heading B\n## Heading C\n## Heading D\n## Heading E\n## Heading F\n## Heading G\n## Heading H\n## Heading I\n## Heading J\n## Heading K\n## Heading L\n## Heading M\n## Heading N\n## Heading O\n## Heading P\n## Heading Q\n## Heading R\n## Heading S\n## Heading T\n## Heading U\n## Heading V\n## Heading W\n## Heading X\n## Heading Y\n## Heading Z\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_36.md", "content": "# Chapter 36\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_37.md", "content": "# Chapter 37\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_38.md", "content": "# Chapter 38\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_39.md", "content": "# Chapter 39\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_4.md", "content": "# Chapter 4\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_40.md", "content": "# Chapter 40\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_41.md", "content": "# Chapter 41\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_42.md", "content": "# Chapter 42\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_43.md", "content": "# Chapter 43\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_44.md", "content": "# Chapter 44\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_45.md", "content": "# Chapter 45\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_46.md", "content": "# Chapter 46\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_47.md", "content": "# Chapter 47\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_48.md", "content": "# Chapter 48\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_49.md", "content": "# Chapter 49\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_5.md", "content": "# Chapter 5\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_50.md", "content": "# Chapter 50\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_51.md", "content": "# Chapter 51\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_52.md", "content": "# Chapter 52\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_53.md", "content": "# Chapter 53\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_54.md", "content": "# Chapter 54\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_55.md", "content": "# Chapter 55\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_56.md", "content": "# Chapter 56\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_57.md", "content": "# Chapter 57\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_58.md", "content": "# Chapter 58\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_59.md", "content": "# Chapter 59\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_6.md", "content": "# Chapter 6\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_60.md", "content": "# Chapter 60\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_61.md", "content": "# Chapter 61\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_62.md", "content": "# Chapter 62\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_63.md", "content": "# Chapter 63\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_64.md", "content": "# Chapter 64\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_65.md", "content": "# Chapter 65\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_66.md", "content": "# Chapter 66\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_67.md", "content": "# Chapter 67\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_68.md", "content": "# Chapter 68\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_69.md", "content": "# Chapter 69\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_7.md", "content": "# Chapter 7\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_70.md", "content": "# Chapter 70\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_71.md", "content": "# Chapter 71\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_72.md", "content": "# Chapter 72\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_73.md", "content": "# Chapter 73\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_74.md", "content": "# Chapter 74\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_75.md", "content": "# Chapter 75\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_76.md", "content": "# Chapter 76\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_77.md", "content": "# Chapter 77\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_78.md", "content": "# Chapter 78\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_79.md", "content": "# Chapter 79\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_8.md", "content": "# Chapter 8\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_80.md", "content": "# Chapter 80\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_81.md", "content": "# Chapter 81\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_82.md", "content": "# Chapter 82\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_83.md", "content": "# Chapter 83\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_84.md", "content": "# Chapter 84\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_85.md", "content": "# Chapter 85\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_86.md", "content": "# Chapter 86\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_87.md", "content": "# Chapter 87\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_88.md", "content": "# Chapter 88\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_89.md", "content": "# Chapter 89\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_9.md", "content": "# Chapter 9\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_90.md", "content": "# Chapter 90\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_91.md", "content": "# Chapter 91\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_92.md", "content": "# Chapter 92\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_93.md", "content": "# Chapter 93\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_94.md", "content": "# Chapter 94\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_95.md", "content": "# Chapter 95\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_96.md", "content": "# Chapter 96\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_97.md", "content": "# Chapter 97\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_98.md", "content": "# Chapter 98\n" }, { "path": "tests/gui/books/sidebar-scroll/src/chapter_99.md", "content": "# Chapter 99\n" }, { "path": "tests/gui/heading-nav-collapsed.goml", "content": "// Tests for collapsed heading sidebar navigation.\n\nset-window-size: (1400, 800)\ngo-to: |DOC_PATH| + \"heading-nav/collapsed.html\"\n\nassert-count: (\".header-item\", 11)\nassert-count: (\".current-header\", 1)\nassert-text: (\".current-header\", \"Heading 1\")\n// Collapsed elements do not have \"expanded\" class.\nassert-attribute: (\"li:has(> span > a[href='#heading-12'])\", {\"class\": \"header-item\"})\nassert-attribute: (\"li:has(> span > a[href='#heading-21'])\", {\"class\": \"header-item\"})\n\nassert-property: (\"div.on-this-page\", {\"innerHTML\": '
  1. Heading 1
    1. Heading 1.1
    2. Heading 1.2
      ❱
      1. Heading 1.2.1
      2. Heading 1.2.2
    3. Heading 1.3
  2. Heading 2
    1. Heading 2.1
      ❱
      1. Heading 2.1.1
        ❱
        1. Heading 2.1.1.1
          ❱
          1. Heading 2.1.1.1.1
'})\n\n// Click 1.2, expands it.\nclick: \"a.header-in-summary[href='#heading-12']\"\nassert-attribute: (\"li:has(> span > a[href='#heading-12'])\", {\"class\": \"header-item expanded\"})\nassert-attribute: (\"li:has(> span > a[href='#heading-21'])\", {\"class\": \"header-item\"})\nassert-css: (\"//a[@href='#heading-12']/../following-sibling::ol\", {\"display\": \"block\"})\n\n// Click 1.1, should collapse it.\nclick: \"a.header-in-summary[href='#heading-11']\"\nassert-attribute: (\"li:has(> span > a[href='#heading-12'])\", {\"class\": \"header-item\"})\nassert-attribute: (\"li:has(> span > a[href='#heading-21'])\", {\"class\": \"header-item\"})\nassert-css: (\"//a[@href='#heading-12']/../following-sibling::ol\", {\"display\": \"none\"})\n\n// Click the chevron, should expand it.\nclick: \"a.header-in-summary[href='#heading-12'] ~ a.header-toggle\"\nassert-attribute: (\"li:has(> span > a[href='#heading-12'])\", {\"class\": \"header-item expanded\"})\nassert-attribute: (\"li:has(> span > a[href='#heading-21'])\", {\"class\": \"header-item\"})\nassert-css: (\"//a[@href='#heading-12']/../following-sibling::ol\", {\"display\": \"block\"})\n\n// Click 1.3\nclick: \"a.header-in-summary[href='#heading-13']\"\n// Everything should be collapsed\nassert-attribute: (\"li:has(> span > a[href='#heading-12'])\", {\"class\": \"header-item\"})\nassert-attribute: (\"li:has(> span > a[href='#heading-21'])\", {\"class\": \"header-item\"})\nassert-css: (\"//a[@href='#heading-12']/../following-sibling::ol\", {\"display\": \"none\"})\nassert-css: (\"//a[@href='#heading-21']/../following-sibling::ol\", {\"display\": \"none\"})\nassert-attribute: (\"li:has(> span > a[href='#heading-12'])\", {\"class\": \"header-item\"})\nassert-attribute: (\"li:has(> span > a[href='#heading-21'])\", {\"class\": \"header-item\"})\nassert-attribute: (\"li:has(> span > a[href='#heading-211'])\", {\"class\": \"header-item\"})\nassert-attribute: (\"li:has(> span > a[href='#heading-2111'])\", {\"class\": \"header-item\"})\n\n// Scroll to bottom of page\npress-key: 'PageDown'\npress-key: 'PageDown'\npress-key: 'PageDown'\npress-key: 'PageDown'\n// 2.1.1.1.1 should be visible, and all the chevrons should be open, and expanded should be on each one\nassert-attribute: (\"li:has(> span > a[href='#heading-12'])\", {\"class\": \"header-item\"})\nassert-attribute: (\"li:has(> span > a[href='#heading-21'])\", {\"class\": \"header-item expanded\"})\nassert-attribute: (\"li:has(> span > a[href='#heading-211'])\", {\"class\": \"header-item expanded\"})\nassert-attribute: (\"li:has(> span > a[href='#heading-2111'])\", {\"class\": \"header-item expanded\"})\nassert-css: (\"//a[@href='#heading-12']/../following-sibling::ol\", {\"display\": \"none\"})\nassert-css: (\"//a[@href='#heading-21']/../following-sibling::ol\", {\"display\": \"block\"})\nassert-css: (\"//a[@href='#heading-211']/../following-sibling::ol\", {\"display\": \"block\"})\nassert-css: (\"//a[@href='#heading-2111']/../following-sibling::ol\", {\"display\": \"block\"})\n" }, { "path": "tests/gui/heading-nav-current-to-bottom.goml", "content": "// Checks that the \"current\" header works even when there are headers near the\n// bottom.\n\nset-window-size: (1400, 800)\ngo-to: |DOC_PATH| + \"heading-nav/current-to-bottom.html\"\nassert-count: (\".current-header\", 1)\nassert-text: (\".current-header\", \"First header\")\n\nscroll-to: \"#scroll-to-1\"\nassert-text: (\".current-header\", \"First header\")\nscroll-to: \"#scroll-to-2\"\nassert-text: (\".current-header\", \"First header\")\nscroll-to: \"#scroll-to-3\"\nassert-text: (\".current-header\", \"First header\")\nscroll-to: \"#scroll-to-4\"\nassert-text: (\".current-header\", \"First header\")\nscroll-to: \"#scroll-to-5\"\nassert-text: (\".current-header\", \"First header\")\nscroll-to: \"#scroll-to-6\"\nassert-text: (\".current-header\", \"First header\")\nscroll-to: \"#scroll-to-7\"\nassert-text: (\".current-header\", \"First header\")\nscroll-to: \"#scroll-to-8\"\nassert-text: (\".current-header\", \"First header\")\nscroll-to: \"#scroll-to-9\"\nassert-text: (\".current-header\", \"First header\")\nscroll-to: \"#scroll-to-10\"\nassert-text: (\".current-header\", \"First header\")\nscroll-to: \"#scroll-to-11\"\nassert-text: (\".current-header\", \"First header\")\nscroll-to: \"#scroll-to-12\"\nassert-text: (\".current-header\", \"First header\")\nscroll-to: \"#scroll-to-13\"\nassert-text: (\".current-header\", \"First header\")\nscroll-to: \"#scroll-to-14\"\nassert-text: (\".current-header\", \"First header\")\nscroll-to: \"#scroll-to-15\"\nassert-text: (\".current-header\", \"First header\")\nscroll-to: \"#scroll-to-16\"\nassert-text: (\".current-header\", \"First header\")\nscroll-to: \"#scroll-to-17\"\nassert-text: (\".current-header\", \"First header\")\nscroll-to: \"#scroll-to-18\"\nassert-text: (\".current-header\", \"First header\")\nscroll-to: \"#scroll-to-19\"\nassert-text: (\".current-header\", \"First header\")\nscroll-to: \"#scroll-to-20\"\nassert-text: (\".current-header\", \"First header\")\nscroll-to: \"#scroll-to-21\"\nwait-for-text: (\".current-header\", \"Second sub-header\")\nscroll-to: \"#scroll-to-22\"\nassert-text: (\".current-header\", \"Second sub-header\")\nscroll-to: \"#scroll-to-23\"\nassert-text: (\".current-header\", \"Second sub-header\")\nscroll-to: \"#scroll-to-24\"\nassert-text: (\".current-header\", \"Second sub-header\")\nscroll-to: \"#scroll-to-25\"\nwait-for-text: (\".current-header\", \"Fifth header\")\n" }, { "path": "tests/gui/heading-nav-empty.goml", "content": "// When there aren't any headings, there shouldn't be any header items in the sidebar.\n\nset-window-size: (1400, 800)\ngo-to: |DOC_PATH| + \"heading-nav/empty.html\"\nassert-count: (\".header-item\", 0)\nassert-count: (\".current-header\", 0)\n" }, { "path": "tests/gui/heading-nav-filter.goml", "content": "// Tests for collapsed heading sidebar navigation.\n\nset-window-size: (1400, 800)\ngo-to: |DOC_PATH| + \"heading-nav/filtered-headings.html?highlight=skateboard#skateboard\"\n\nassert-property: (\"//h2[@id='skateboard']\", {\"innerHTML\": 'Skateboard'})\n\nassert-property: (\"//a[contains(@class, 'header-in-summary') and @href='#skateboard']\", {\"innerHTML\": 'Skateboard'})\n" }, { "path": "tests/gui/heading-nav-folded.goml", "content": "// Tests when chapter folding is enabled.\n\ngo-to: |DOC_PATH| + \"heading-nav-folded/index.html\"\n" }, { "path": "tests/gui/heading-nav-large-intro.goml", "content": "// When there is a large intro, there shouldn't be any \"current\" headers until\n// you scroll down and make it visible on screen.\n\nset-window-size: (1400, 800)\ngo-to: |DOC_PATH| + \"heading-nav/large-intro.html\"\nassert-count: (\".header-item\", 1)\nassert-count: (\".current-header\", 0)\n\nscroll-to: \"#first-header\"\nwait-for-count: (\".current-header\", 1)\nassert-text: (\".current-header\", \"First header\")\n\n// Scrolling back to the top should set it to 0.\nscroll-to: (0, 0)\nwait-for-count: (\".current-header\", 0)\n" }, { "path": "tests/gui/heading-nav-markup.goml", "content": "// When a header has various markup, the sidebar should replicate it.\n\nset-window-size: (1400, 800)\ngo-to: |DOC_PATH| + \"heading-nav/markup.html\"\n\nassert-count: (\".header-item\", 4)\nassert-count: (\".current-header\", 1)\nassert-text: (\".current-header\", \"Heading with code or italic or bold or strike\")\nassert-property: (\".current-header\", {\"innerHTML\": \"Heading with code or italic or bold or strike\"})\n\n// Clicking the custom one should work and should make it current.\nclick: \"a.header-in-summary[href='#custom-id']\"\nassert-count: (\".current-header\", 1)\nassert-text: (\".current-header\", \"Heading with a custom id\")\n\n// Click the one with HTML, and check it.\nclick: \"a.header-in-summary[href='#heading-with-html']\"\nassert-count: (\".current-header\", 1)\nassert-text: (\".current-header\", \"Heading with html\")\n" }, { "path": "tests/gui/heading-nav-normal-intro.goml", "content": "// When there is a normal-sized intro, when the page loads the first heading\n// should be \"current\".\n\nset-window-size: (1400, 800)\ngo-to: |DOC_PATH| + \"heading-nav/normal-intro.html\"\nassert-count: (\".header-item\", 3)\nassert-count: (\".current-header\", 1)\nassert-text: (\".current-header\", \"The first heading\")\n\nclick: \"a[href='#and-a-sub-heading']\"\nwait-for-text: (\".current-header\", \"And a sub heading\")\n" }, { "path": "tests/gui/heading-nav-unusual-levels.goml", "content": "// Tests for unusual heading levels\n\nset-window-size: (1400, 800)\ngo-to: |DOC_PATH| + \"heading-nav/unusual-heading-levels.html\"\n\nassert-property: (\"//a[@href='unusual-heading-levels.html']/../following-sibling::div\", {\"innerHTML\": '
    1. Heading 3
  1. Heading 2
      1. Heading 5
      2. Heading 5.1
'})\n" }, { "path": "tests/gui/help.goml", "content": "// This GUI test checks help popup.\n\ngo-to: |DOC_PATH| + \"basic/index.html\"\nassert-css: (\"#mdbook-help-container\", {\"display\": \"none\"})\npress-key: '?'\nwait-for-css: (\"#mdbook-help-container\", {\"display\": \"flex\"})\npress-key: 'Escape'\nwait-for-css: (\"#mdbook-help-container\", {\"display\": \"none\"})\npress-key: '?'\nwait-for-css: (\"#mdbook-help-container\", {\"display\": \"flex\"})\n// Click inside does nothing.\nclick: \"#mdbook-help-popup\"\nwait-for-css: (\"#mdbook-help-container\", {\"display\": \"flex\"})\n// Click outside dismisses.\nclick: \"*\"\nwait-for-css: (\"#mdbook-help-container\", {\"display\": \"none\"})\n" }, { "path": "tests/gui/highlighting.goml", "content": "// This tests syntax highlighting.\n\ngo-to: |DOC_PATH| + \"highlighting/index.html\"\n\nassert: \"#apache ~ pre > code > span.hljs-comment\"\nassert: \"#armasm ~ pre > code > span.hljs-symbol\"\nassert: \"#bash ~ pre > code > span.hljs-meta\"\nassert: \"#c ~ pre > code > span.hljs-meta\"\nassert: \"#coffeescript ~ pre > code > span.hljs-title\"\nassert: \"#cpp ~ pre > code > span.hljs-meta\"\nassert: \"#csharp ~ pre > code > span.hljs-keyword\"\nassert: \"#css ~ pre > code > span.hljs-keyword\"\nassert: \"#d ~ pre > code > span.hljs-comment\"\nassert: \"#diff ~ pre > code > span.hljs-comment\"\nassert: \"#go ~ pre > code > span.hljs-keyword\"\n// Not clear why this doesn't have the hljs- prefix.\nassert: \"#handlebars ~ pre > code > span.xml\"\nassert: \"#haskell ~ pre > code > span.hljs-title\"\nassert: \"#http ~ pre > code > span.hljs-keyword\"\nassert: \"#ini ~ pre > code > span.hljs-comment\"\nassert: \"#java ~ pre > code > span.hljs-class\"\nassert: \"#javascript ~ pre > code > span.hljs-function\"\nassert: \"#json ~ pre > code > span.hljs-attr\"\nassert: \"#julia ~ pre > code > span.hljs-comment\"\nassert: \"#kotlin ~ pre > code > span.hljs-keyword\"\nassert: \"#less ~ pre > code > span.hljs-keyword\"\nassert: \"#lua ~ pre > code > span.hljs-comment\"\nassert: \"#makefile ~ pre > code > span.hljs-comment\"\nassert: \"#markdown ~ pre > code > span.hljs-section\"\nassert: \"#nginx ~ pre > code > span.hljs-attribute\"\nassert: \"#nim ~ pre > code > span.hljs-keyword\"\nassert: \"#objectivec ~ pre > code > span.hljs-meta\"\nassert: \"#nix ~ pre > code > span.hljs-keyword\"\nassert: \"#perl ~ pre > code > span.hljs-keyword\"\nassert: \"#php ~ pre > code > span.hljs-meta\"\nassert: \"#properties ~ pre > code > span.hljs-comment\"\nassert: \"#python ~ pre > code > span.hljs-meta\"\nassert: \"#r ~ pre > code > span.hljs-keyword\"\nassert: \"#ruby ~ pre > code > span.hljs-comment\"\nassert: \"#rust ~ pre > code > span.hljs-function\"\nassert: \"#scala ~ pre > code > span.hljs-comment\"\nassert: \"#scss ~ pre > code > span.hljs-comment\"\nassert: \"#shell ~ pre > code > span.hljs-meta\"\nassert: \"#sql ~ pre > code > span.hljs-keyword\"\nassert: \"#swift ~ pre > code > span.hljs-keyword\"\nassert: \"#typescript ~ pre > code > span.hljs-keyword\"\nassert: \"#x86asm ~ pre > code > span.hljs-meta\"\nassert: \"#xml ~ pre > code > span.hljs-meta\"\nassert: \"#yaml ~ pre > code > span.hljs-meta\"\n" }, { "path": "tests/gui/move-between-pages.goml", "content": "// This tests pressing the left and right arrows moving to previous and next page.\n\ngo-to: |DOC_PATH| + \"all-summary/index.html\"\n\n// default page is the first chapter\nassert-text: (\"title\", \"Prefix 1 - all-summary\")\n\n// Trying to move to the left beyond the prefix pages - nothing changes\npress-key: 'ArrowLeft'\nassert-text: (\"title\", \"Prefix 1 - all-summary\")\n\n// Move left\ngo-to: |DOC_PATH| + \"all-summary/intro.html\"\nassert-text: (\"title\", \"Introduction - all-summary\")\n\npress-key: 'ArrowLeft'\nassert-text: (\"title\", \"Prefix 2 - all-summary\")\n\npress-key: 'ArrowLeft'\nassert-text: (\"title\", \"Prefix 1 - all-summary\")\n\n// Move right\npress-key: 'ArrowRight'\nassert-text: (\"title\", \"Prefix 2 - all-summary\")\n\npress-key: 'ArrowRight'\nassert-text: (\"title\", \"Introduction - all-summary\")\n\npress-key: 'ArrowRight'\nassert-text: (\"title\", \"P1 C1 - all-summary\")\n\npress-key: 'ArrowRight'\nassert-text: (\"title\", \"P2 C1 - all-summary\")\n\npress-key: 'ArrowRight'\nassert-text: (\"title\", \"Suffix 1 - all-summary\")\n\npress-key: 'ArrowRight'\nassert-text: (\"title\", \"Suffix 2 - all-summary\")\n\n// Try to go beyond the last page\npress-key: 'ArrowRight'\nassert-text: (\"title\", \"Suffix 2 - all-summary\")\n" }, { "path": "tests/gui/redirect.goml", "content": "go-to: |DOC_PATH| + \"redirect/inner/old.html\"\nassert-window-property: ({\"location\": |DOC_PATH| + \"redirect/new-chapter.html\"})\n\n// Check that it preserves fragments when redirecting.\ngo-to: |DOC_PATH| + \"redirect/inner/old.html#fragment\"\nassert-window-property: ({\"location\": |DOC_PATH| + \"redirect/new-chapter.html#fragment\"})\n\n// The fragment one here isn't necessary, but should still work.\ngo-to: |DOC_PATH| + \"redirect/pointless-fragment.html\"\nassert-window-property: ({\"location\": |DOC_PATH| + \"redirect/new-chapter.html\"})\ngo-to: |DOC_PATH| + \"redirect/pointless-fragment.html#foo\"\nassert-window-property: ({\"location\": |DOC_PATH| + \"redirect/new-chapter.html#foo\"})\n\n// Page rename, and a fragment rename.\ngo-to: |DOC_PATH| + \"redirect/rename-page-and-fragment.html\"\nassert-window-property: ({\"location\": |DOC_PATH| + \"redirect/new-chapter.html\"})\ngo-to: |DOC_PATH| + \"redirect/rename-page-and-fragment.html#orig\"\nassert-window-property: ({\"location\": |DOC_PATH| + \"redirect/new-chapter.html#new\"})\n\n// Page rename, and the fragment goes to a *different* page from the default.\ngo-to: |DOC_PATH| + \"redirect/rename-page-fragment-elsewhere.html\"\nassert-window-property: ({\"location\": |DOC_PATH| + \"redirect/new-chapter.html\"})\ngo-to: |DOC_PATH| + \"redirect/rename-page-fragment-elsewhere.html#orig\"\nassert-window-property: ({\"location\": |DOC_PATH| + \"redirect/other-chapter.html#new\"})\n\n// Rename fragment on an existing page.\ngo-to: |DOC_PATH| + \"redirect/new-chapter.html#orig\"\nassert-window-property: ({\"location\": |DOC_PATH| + \"redirect/new-chapter.html#new\"})\n\n// Other fragments aren't affected.\ngo-to: |DOC_PATH| + \"redirect/index.html\" // Reset page since redirects are processed on load.\ngo-to: |DOC_PATH| + \"redirect/new-chapter.html\"\nassert-window-property: ({\"location\": |DOC_PATH| + \"redirect/new-chapter.html\"})\ngo-to: |DOC_PATH| + \"redirect/index.html\" // Reset page since redirects are processed on load.\ngo-to: |DOC_PATH| + \"redirect/new-chapter.html#dont-change\"\nassert-window-property: ({\"location\": |DOC_PATH| + \"redirect/new-chapter.html#dont-change\"})\n\n// Rename fragment on an existing page to another page.\ngo-to: |DOC_PATH| + \"redirect/index.html\" // Reset page since redirects are processed on load.\ngo-to: |DOC_PATH| + \"redirect/new-chapter.html#orig-new-chapter\"\nassert-window-property: ({\"location\": |DOC_PATH| + \"redirect/other-chapter.html#new\"})\n" }, { "path": "tests/gui/runner.rs", "content": "//! The GUI test runner.\n//!\n//! This uses the browser-ui-test npm package to use a headless Chrome to\n//! exercise the behavior of rendered books. See `CONTRIBUTING.md` for more\n//! information.\n\nuse serde_json::Value;\nuse std::fs::read_to_string;\nuse std::path::Path;\nuse std::process::{Command, Output};\n\nfn get_available_browser_ui_test_version_inner(global: bool) -> Option {\n let mut command = Command::new(\"npm\");\n command\n .arg(\"list\")\n .arg(\"--parseable\")\n .arg(\"--long\")\n .arg(\"--depth=0\");\n if global {\n command.arg(\"--global\");\n }\n let stdout = command.output().expect(\"`npm` command not found\").stdout;\n let lines = String::from_utf8_lossy(&stdout);\n lines\n .lines()\n .find_map(|l| l.split(':').nth(1)?.strip_prefix(\"browser-ui-test@\"))\n .map(std::borrow::ToOwned::to_owned)\n}\n\nfn get_available_browser_ui_test_version() -> Option {\n get_available_browser_ui_test_version_inner(false)\n .or_else(|| get_available_browser_ui_test_version_inner(true))\n}\n\nfn expected_browser_ui_test_version() -> String {\n let content = read_to_string(\"package.json\").expect(\"failed to read `package.json`\");\n let v: Value = serde_json::from_str(&content).expect(\"failed to parse `package.json`\");\n let Some(dependencies) = v.get(\"dependencies\") else {\n panic!(\"Missing `dependencies` key in `package.json`\");\n };\n let Some(browser_ui_test) = dependencies.get(\"browser-ui-test\") else {\n panic!(\"Missing `browser-ui-test` key in \\\"dependencies\\\" object in `package.json`\");\n };\n let Value::String(version) = browser_ui_test else {\n panic!(\"`browser-ui-test` version is not a string\");\n };\n version.trim().to_string()\n}\n\nfn main() {\n let browser_ui_test_version = expected_browser_ui_test_version();\n match get_available_browser_ui_test_version() {\n Some(version) => {\n if version != browser_ui_test_version {\n eprintln!(\n \"⚠️ Installed version of browser-ui-test (`{version}`) is different than the \\\n one used in the CI (`{browser_ui_test_version}`) You can install this version \\\n using `npm update browser-ui-test` or by using `npm install browser-ui-test\\\n @{browser_ui_test_version}`\",\n );\n }\n }\n None => {\n panic!(\n \"`browser-ui-test` is not installed. You can install this package using `npm \\\n update browser-ui-test` or by using `npm install browser-ui-test\\\n @{browser_ui_test_version}`\",\n );\n }\n }\n\n let out_dir = Path::new(env!(\"CARGO_TARGET_TMPDIR\")).join(\"gui\");\n build_books(&out_dir);\n run_browser_ui_test(&out_dir);\n}\n\nfn build_books(out_dir: &Path) {\n let root = Path::new(env!(\"CARGO_MANIFEST_DIR\"));\n let books_dir = root.join(\"tests/gui/books\");\n for entry in books_dir.read_dir().unwrap() {\n let entry = entry.unwrap();\n let path = entry.path();\n if !path.is_dir() {\n continue;\n }\n println!(\"Building `{}`\", path.display());\n let mut cmd = Command::new(env!(\"CARGO_BIN_EXE_mdbook\"));\n let output = cmd\n .arg(\"build\")\n .arg(\"--dest-dir\")\n .arg(out_dir.join(path.file_name().unwrap()))\n .arg(&path)\n .output()\n .expect(\"mdbook should be built\");\n check_status(&cmd, &output);\n }\n}\n\nfn check_status(cmd: &Command, output: &Output) {\n if !output.status.success() {\n eprintln!(\"error: `{cmd:?}` failed\");\n let stdout = std::str::from_utf8(&output.stdout).expect(\"stdout is not utf8\");\n let stderr = std::str::from_utf8(&output.stderr).expect(\"stderr is not utf8\");\n eprintln!(\"\\n--- stdout\\n{stdout}\\n--- stderr\\n{stderr}\");\n std::process::exit(1);\n }\n}\n\nfn run_browser_ui_test(out_dir: &Path) {\n let mut command = Command::new(\"npx\");\n let mut doc_path = format!(\"file://{}\", out_dir.display());\n if !doc_path.ends_with('/') {\n doc_path.push('/');\n }\n command\n .arg(\"browser-ui-test\")\n .args([\"--variable\", \"DOC_PATH\", doc_path.as_str()])\n .args([\"--display-format\", \"compact\"]);\n\n for arg in std::env::args().skip(1) {\n if arg == \"--disable-headless-test\" {\n command.arg(\"--no-headless\");\n } else if arg.starts_with(\"--\") {\n command.arg(arg);\n } else {\n command.args([\"--filter\", arg.as_str()]);\n }\n }\n\n let test_dir = \"tests/gui\";\n command.args([\"--test-folder\", test_dir]);\n\n // Then we run the GUI tests on it.\n let status = command.status().expect(\"failed to get command output\");\n assert!(status.success(), \"{status:?}\");\n}\n" }, { "path": "tests/gui/search.goml", "content": "// This tests basic search behavior.\n\nfail-on-js-error: true\ngo-to: |DOC_PATH| + \"search/index.html\"\n\ndefine-function: (\n \"open-search\",\n [],\n block {\n assert-css: (\"#mdbook-search-wrapper\", {\"display\": \"none\"})\n press-key: 's'\n wait-for-css-false: (\"#mdbook-search-wrapper\", {\"display\": \"none\"})\n }\n)\n\ncall-function: (\"open-search\", {})\nassert-text: (\"#mdbook-searchresults-header\", \"\")\nwrite: \"extraordinary\"\nwait-for-text: (\"#mdbook-searchresults-header\", \"2 search results for 'extraordinary':\")\n// Close the search display\npress-key: 'Escape'\nwait-for-css: (\"#mdbook-search-wrapper\", {\"display\": \"none\"})\n// Reopening the search should show the last value\ncall-function: (\"open-search\", {})\nassert-text: (\"#mdbook-searchresults-header\", \"2 search results for 'extraordinary':\")\n// Navigate to a sub-chapter\ngo-to: \"./inner/chapter_2.html\"\nassert-text: (\"#mdbook-searchresults-header\", \"\")\ncall-function: (\"open-search\", {})\nwrite: \"kaleidoscope\"\nwait-for-text: (\"#mdbook-searchresults-header\", \"2 search results for 'kaleidoscope':\")\n\n// Now we test search shortcuts and more page changes.\ngo-to: |DOC_PATH| + \"search/index.html\"\n\n// This check is to ensure that the search bar is inside the search wrapper.\nassert: \"#mdbook-search-wrapper #mdbook-searchbar\"\nassert-css: (\"#mdbook-search-wrapper\", {\"display\": \"none\"})\n\n// Now we make sure the search input appear with the `S` shortcut.\npress-key: 's'\nwait-for-css-false: (\"#mdbook-search-wrapper\", {\"display\": \"none\"})\n// We ensure the search bar has the focus.\nwait-for: \"#mdbook-searchbar:focus\"\n// Pressing a key will therefore update the search input.\npress-key: 't'\nassert-text: (\"#mdbook-searchbar\", \"t\")\n\n// Now we press `Escape` to ensure that the search input disappears again.\npress-key: 'Escape'\nwait-for-css: (\"#mdbook-search-wrapper\", {\"display\": \"none\"})\n\n// Making it appear by clicking on the search button.\nclick: \"#mdbook-search-toggle\"\nwait-for-css: (\"#mdbook-search-wrapper\", {\"display\": \"block\"})\n// We ensure the search bar has the focus.\nassert: \"#mdbook-searchbar:focus\"\n\n// We input \"thunder\".\nwrite: \"thunder\"\n// The results should now appear.\nwait-for-text: (\"#mdbook-searchresults-header\", \"1 search result for 'thunder':\")\nassert: \"#mdbook-searchresults\"\n// Ensure that the URL was updated as well.\nassert-document-property: ({\"URL\": \"?search=thunder\"}, ENDS_WITH)\n\n// Now we ensure that when we land on the page with a \"search in progress\", the search results are\n// loaded and that the search input has focus.\ngo-to: |DOC_PATH| + \"search/index.html?search=thunder\"\nwait-for-text: (\"#mdbook-searchresults-header\", \"1 search result for 'thunder':\")\nassert: \"#mdbook-searchbar:focus\"\nassert: \"#mdbook-searchresults\"\n\n// And now we press `Escape` to close everything.\npress-key: 'Escape'\nwait-for-css: (\"#mdbook-search-wrapper\", {\"display\": \"none\"})\n" }, { "path": "tests/gui/sidebar-active.goml", "content": "// This GUI test checks the active page sidebar highlight.\n\ngo-to: |DOC_PATH| + \"all-summary/index.html\"\n\nassert-text: (\"mdbook-sidebar-scrollbox a.active\", \"Prefix 1\")\n\ngo-to: |DOC_PATH| + \"all-summary/part-1/chapter-1.html\"\n\nassert-text: (\"mdbook-sidebar-scrollbox a.active\", \"3. P1 C1\")\n\ngo-to: |DOC_PATH| + \"all-summary/index.html?highlight=test\"\n\nassert-text: (\"mdbook-sidebar-scrollbox a.active\", \"Prefix 1\")\n\ngo-to: |DOC_PATH| + \"all-summary/part-1/chapter-1.html?highlight=test\"\n\nassert-text: (\"mdbook-sidebar-scrollbox a.active\", \"3. P1 C1\")\n" }, { "path": "tests/gui/sidebar-nojs.goml", "content": "// This GUI test checks that the sidebar takes the whole height when it's inside\n// an iframe (because of JS disabled).\n// Regression test for .\n\n// We disable javascript\njavascript: false\ngo-to: |DOC_PATH| + \"basic/index.html\"\nstore-value: (height, 1028)\nset-window-size: (1028, |height|)\n\nwithin-iframe: (\".sidebar-iframe-outer\", block {\n assert-size: (\" body\", {\"height\": |height|})\n})\n" }, { "path": "tests/gui/sidebar-scroll.goml", "content": "// This GUI test checks the sidebar scroll position when navigating.\n\nstore-value: (windowHeight, 900)\nset-window-size: (1200, |windowHeight|)\ngo-to: |DOC_PATH| + \"sidebar-scroll/index.html\"\nassert-property: (\"mdbook-sidebar-scrollbox\", {\"scrollTop\": 0})\n\nclick: \".chapter a[href='chapter_2.html']\"\nassert-text: (\"title\", \"Chapter 2 - sidebar-scroll\")\nassert-property: (\"mdbook-sidebar-scrollbox\", {\"scrollTop\": 0})\n\nclick: \".chapter a[href='chapter_10.html']\"\nassert-text: (\"title\", \"Chapter 10 - sidebar-scroll\")\nassert-property: (\"mdbook-sidebar-scrollbox\", {\"scrollTop\": 0})\n\n// Check that heading nav of chapter 10 pushes 11 off the bottom.\nstore-position: (\".chapter a[href='chapter_11.html']\", {\"y\": chapter_y})\nassert: |chapter_y| > |windowHeight|\n\n// Clicking 11 should scroll back up because it is not possible for it to stay\n// in position since there are only a few lines above.\nclick: \".chapter a[href='chapter_11.html']\"\nassert-text: (\"title\", \"Chapter 11 - sidebar-scroll\")\nassert-property: (\"mdbook-sidebar-scrollbox\", {\"scrollTop\": 0})\n\n// Scroll down a little, and click on a chapter that can stay in place when\n// clicked.\nscroll-element-to: (\"mdbook-sidebar-scrollbox\", (0, 230))\nstore-property: (\"mdbook-sidebar-scrollbox\", {\"scrollTop\": sidebarScrollTop})\nassert: |sidebarScrollTop| > 0\nclick: \".chapter a[href='chapter_35.html']\"\nassert-text: (\"title\", \"Chapter 35 - sidebar-scroll\")\nassert-property: (\"mdbook-sidebar-scrollbox\", {\"scrollTop\": |sidebarScrollTop|})\n\n// Go to the next chapter, and verify that it scrolls to the middle.\npress-key: \"ArrowRight\"\nassert-text: (\"title\", \"Chapter 36 - sidebar-scroll\")\n// The active link should be roughly in the middle of the screen.\nstore-position: (\".chapter a.active\", {\"y\": active_y})\n// Approximate check just in case the browser has slight rendering differences.\nassert: |active_y| > 400\nassert: |active_y| < 450\n\n// Go to something near the top, it shouldn't scroll.\nstore-property: (\"mdbook-sidebar-scrollbox\", {\"scrollTop\": sidebarScrollTop})\nclick: \".chapter a[href='chapter_24.html']\"\nassert-text: (\"title\", \"Chapter 24 - sidebar-scroll\")\nassert-property: (\"mdbook-sidebar-scrollbox\", {\"scrollTop\": |sidebarScrollTop|})\n\n// Go to the last chapter, and verify it is scrolled to the bottom.\ngo-to: |DOC_PATH| + \"sidebar-scroll/chapter_100.html\"\nstore-property: (\"mdbook-sidebar-scrollbox\", {\"scrollTop\": scrollTop, \"scrollHeight\": scrollHeight, \"clientHeight\": clientHeight})\n// This needs to be approximate since there is a slight difference.\nassert: |scrollTop| >= |scrollHeight| - |clientHeight| - 1\n\n// Clicking upwards shouldn't scroll.\nstore-property: (\"mdbook-sidebar-scrollbox\", {\"scrollTop\": sidebarScrollTop})\nclick: \".chapter a[href='chapter_97.html']\"\nassert-text: (\"title\", \"Chapter 97 - sidebar-scroll\")\nassert-property: (\"mdbook-sidebar-scrollbox\", {\"scrollTop\": |sidebarScrollTop|})\n\nstore-property: (\"mdbook-sidebar-scrollbox\", {\"scrollTop\": sidebarScrollTop})\nclick: \".chapter a[href='chapter_76.html']\"\nassert-text: (\"title\", \"Chapter 76 - sidebar-scroll\")\nassert-property: (\"mdbook-sidebar-scrollbox\", {\"scrollTop\": |sidebarScrollTop|})\n" }, { "path": "tests/gui/sidebar.goml", "content": "// This GUI test checks sidebar hide/show and also its behaviour on smaller\n// width.\n\ngo-to: |DOC_PATH| + \"all-summary/index.html\"\nset-window-size: (1100, 600)\n// Need to reload for the new size to be taken account by the JS.\nreload:\n\nstore-value: (content_indent, 308)\nstore-value: (sidebar_storage_value, \"mdbook-sidebar\")\nstore-value: (sidebar_storage_hidden_value, \"hidden\")\nstore-value: (sidebar_storage_displayed_value, \"visible\")\n\ndefine-function: (\n \"hide-sidebar\",\n [],\n block {\n assert-position: (\"#mdbook-page-wrapper\", {\"x\": |content_indent|})\n\n // We now hide the sidebar.\n click: \"#mdbook-sidebar-toggle\"\n wait-for-css: (\"#mdbook-sidebar\", {\"display\": \"none\"})\n assert-local-storage: {|sidebar_storage_value|: |sidebar_storage_hidden_value|}\n },\n)\n\ndefine-function: (\n \"show-sidebar\",\n [],\n block {\n assert-css: (\"#mdbook-sidebar\", {\"display\": \"none\"})\n assert-position: (\"#mdbook-page-wrapper\", {\"x\": 0})\n\n // We expand the sidebar.\n click: \"#mdbook-sidebar-toggle\"\n wait-for-css-false: (\"#mdbook-sidebar\", {\"display\": \"none\"})\n // `transform` is 0.3s so we need to wait a bit (0.5s) to ensure the animation is done.\n wait-for: 5000\n assert-css-false: (\"#mdbook-sidebar\", {\"transform\": \"matrix(1, 0, 0, 1, -308, 0)\"})\n // The page content should be moved to the right.\n assert-position: (\"#mdbook-page-wrapper\", {\"x\": |content_indent|})\n assert-local-storage: {|sidebar_storage_value|: |sidebar_storage_displayed_value|}\n },\n)\n\n// Since the sidebar is visible, we should be able to find this text.\nassert-find-text: (\"3. P1 C1\", {\"case-sensitive\": true})\ncall-function: (\"hide-sidebar\", {})\n// Text should not be findeable anymore since the sidebar is collapsed.\nassert-find-text-false: (\"3. P1 C1\", {\"case-sensitive\": true})\ncall-function: (\"show-sidebar\", {})\n// We should be able to find this text again.\nassert-find-text: (\"3. P1 C1\", {\"case-sensitive\": true})\n\n// We now test on smaller width to ensure that the sidebar is collapsed by default.\nset-window-size: (900, 600)\nreload:\ncall-function: (\"show-sidebar\", {})\ncall-function: (\"hide-sidebar\", {})\n\n// We now test that if the sidebar is considered open and we reload the page, since\n// the width is small, it will still be collapsed.\nset-local-storage: {|sidebar_storage_value|: |sidebar_storage_displayed_value|}\nreload:\n// The stored value shouldn't have changed.\nassert-local-storage: {|sidebar_storage_value|: |sidebar_storage_displayed_value|}\n// But the sidebar should be hidden anyway.\nassert-css: (\"#mdbook-sidebar\", {\"display\": \"none\"})\nassert-position: (\"#mdbook-page-wrapper\", {\"x\": 0})\n" }, { "path": "tests/gui/theme.goml", "content": "// Basic theme switcher test.\n\ndebug: true\n\ngo-to: |DOC_PATH| + \"all-summary/index.html\"\n\n// TODO: Dark mode is automatic, how to check that here?\nassert-css: (\"#mdbook-theme-list\", {\"display\": \"none\"})\nclick: \"#mdbook-theme-toggle\"\nassert-css: (\"#mdbook-theme-list\", {\"display\": \"block\"})\nclick: \"#mdbook-theme-rust\"\nassert-attribute: (\"html\", {\"class\": \"js rust\"})\n// Clicking a theme doesn't dismiss the popup.\nassert-css: (\"#mdbook-theme-list\", {\"display\": \"block\"})\nassert-local-storage: {\"mdbook-theme\": \"rust\"}\n\n// Dismiss via toggle.\nclick: \"#mdbook-theme-toggle\"\nassert-css: (\"#mdbook-theme-list\", {\"display\": \"none\"})\n\n// Check for dismissal for click outside.\nclick: \"#mdbook-theme-toggle\"\nassert-css: (\"#mdbook-theme-list\", {\"display\": \"block\"})\nclick: \"main\"\nassert-css: (\"#mdbook-theme-list\", {\"display\": \"none\"})\n\n// Check for escape.\nclick: \"#mdbook-theme-toggle\"\nassert-css: (\"#mdbook-theme-list\", {\"display\": \"block\"})\npress-key: 'Escape'\nassert-css: (\"#mdbook-theme-list\", {\"display\": \"none\"})\n\n// Check for navigation retains theme.\ngo-to: \"./part-1/chapter-1.html\"\nassert-attribute: (\"html\", {\"class\": \"rust js\"})\n" }, { "path": "tests/testsuite/README.md", "content": "# Testsuite\n\n## Introduction\n\nThis is the main testsuite for exercising all functionality of mdBook.\n\nTests should be organized into modules based around major features. Tests should use `BookTest` to drive the test. `BookTest` will set up a temp directory, and provides a variety of methods to help create a build books.\n\n## Basic structure of a test\n\nUsing `BookTest`, you typically use it to copy a directory into a temp directory, and then run mdbook commands in that temp directory. You can run the `mdbook` executable, or use the mdbook API to perform whatever tasks you need. Running the executable has the benefit of being able to validate the console output.\n\nSee `build::basic_build` for a simple test example. I recommend reviewing the methods on `BookTest` to learn more, and reviewing some of the existing tests to get a feel for how they are structured.\n\nFor example, let's say you are creating a new theme test. In the `testsuite/theme` directory, create a new directory with the book source that you want to exercise. At a minimum, this needs a `src/SUMMARY.md`, but often you'll also want `book.toml`. Then, in `testsuite/theme.rs`, add a test with `BookTest::from_dir(\"theme/mytest\")`, and then use the methods to perform whatever actions you want.\n\n`BookTest` is designed to be able to chain a series of actions. For example, you can do something like:\n\n```rust\nBookTest::from_dir(\"theme/mytest\")\n .build()\n .check_main_file(\"book/index.html\", str![[\"file contents\"]])\n .change_file(\"src/index.md\", \"new contents\")\n .build()\n .check_main_file(\"book/index.html\", str![[\"new contents\"]]);\n```\n\n## Snapbox\n\nThe testsuite uses [`snapbox`] to drive most of the tests. This library provides the ability to compare strings using a variety of methods. These strings are written in the source code using either the [`str!`] or [`file!`] macros.\n\nThe magic is that you can set the `SNAPSHOTS=overwrite` environment variable, and snapbox will automatically update the strings contents of `str!`, or the file contents of `file!`. This makes it easier to update tests. Snapbox provides nice diffing output, and quite a few other features.\n\nExpected contents can have wildcards like `...` (matches any lines) or `[..]` (matches any characters on a line). See [snapbox filters] for more info and other filters.\n\nTypically when writing a test, I'll just start with an empty `str!` or `file!`, and let snapbox fill it in. Then I review the contents to make sure they are what I expect.\n\nNote that there is some normalization applied to the strings. See `book_test::assert` for how some of these normalizations happen.\n\n[`snapbox`]: https://docs.rs/snapbox/latest/snapbox/\n[`str!`]: https://docs.rs/snapbox/latest/snapbox/macro.str.html\n[`file!`]: https://docs.rs/snapbox/latest/snapbox/macro.file.html\n[snapbox filters]: https://docs.rs/snapbox/latest/snapbox/assert/struct.Assert.html#method.eq\n" }, { "path": "tests/testsuite/book_test.rs", "content": "//! Utility for building and running tests against mdbook.\n\nuse mdbook_core::utils::fs;\nuse mdbook_driver::MDBook;\nuse mdbook_driver::init::BookBuilder;\nuse snapbox::IntoData;\nuse std::collections::BTreeMap;\nuse std::path::{Path, PathBuf};\nuse std::process::Command;\nuse std::sync::atomic::{AtomicU32, Ordering};\n\n/// Test number used for generating unique temp directory names.\nstatic NEXT_TEST_ID: AtomicU32 = AtomicU32::new(0);\n\n#[derive(Clone, Copy, Eq, PartialEq)]\nenum StatusCode {\n Success,\n Failure,\n Code(i32),\n}\n\n/// Main helper for driving mdbook tests.\npub struct BookTest {\n /// The temp directory where the test should perform its work.\n pub dir: PathBuf,\n /// The original source directory if created from [`BookTest::from_dir`].\n original_source: Option,\n /// Snapshot assertion support.\n pub assert: snapbox::Assert,\n /// This indicates whether or not the book has been built.\n built: bool,\n}\n\nimpl BookTest {\n /// Creates a new test, copying the contents from the given directory into\n /// a temp directory.\n pub fn from_dir(dir: &str) -> BookTest {\n // Copy this test book to a temp directory.\n let dir = Path::new(\"tests/testsuite\").join(dir);\n assert!(dir.exists(), \"{dir:?} should exist\");\n let tmp = Self::new_tmp();\n mdbook_core::utils::fs::copy_files_except_ext(\n &dir,\n &tmp,\n true,\n Some(&PathBuf::from(\"book\")),\n &[],\n )\n .unwrap_or_else(|e| panic!(\"failed to copy test book {dir:?} to {tmp:?}: {e:?}\"));\n Self::new(tmp, Some(dir))\n }\n\n /// Creates a new test with an empty temp directory.\n pub fn empty() -> BookTest {\n Self::new(Self::new_tmp(), None)\n }\n\n /// Creates a new test with the given function to initialize a new book.\n ///\n /// The book itself is not built.\n pub fn init(f: impl Fn(&mut BookBuilder)) -> BookTest {\n let tmp = Self::new_tmp();\n let mut bb = MDBook::init(&tmp);\n f(&mut bb);\n bb.build()\n .unwrap_or_else(|e| panic!(\"failed to initialize book at {tmp:?}: {e:?}\"));\n Self::new(tmp, None)\n }\n\n fn new_tmp() -> PathBuf {\n let id = NEXT_TEST_ID.fetch_add(1, Ordering::SeqCst);\n let tmp = Path::new(env!(\"CARGO_TARGET_TMPDIR\"))\n .join(\"ts\")\n .join(format!(\"t{id}\"));\n if tmp.exists() {\n std::fs::remove_dir_all(&tmp)\n .unwrap_or_else(|e| panic!(\"failed to remove {tmp:?}: {e:?}\"));\n }\n fs::create_dir_all(&tmp).unwrap();\n tmp\n }\n\n fn new(dir: PathBuf, original_source: Option) -> BookTest {\n let assert = assert(&dir);\n BookTest {\n dir,\n original_source,\n assert,\n built: false,\n }\n }\n\n /// Checks the contents of an HTML file that it has the given contents\n /// between the `
` tag.\n ///\n /// Normally the contents outside of the `
` tag aren't interesting,\n /// and they add a significant amount of noise.\n #[track_caller]\n pub fn check_main_file(&mut self, path: &str, expected: impl IntoData) -> &mut Self {\n if !self.built {\n self.build();\n }\n let full_path = self.dir.join(path);\n let actual = read_to_string(&full_path);\n let start = actual\n .find(\"
\")\n .unwrap_or_else(|| panic!(\"didn't find
for `{full_path:?}` in:\\n{actual}\"));\n let end = actual.find(\"
\").unwrap();\n let contents = actual[start + 6..end - 7].trim();\n self.assert.eq(contents, expected);\n self\n }\n\n /// Verifies the HTML output of all chapters in a book.\n ///\n /// This calls [`BookTest::check_main_file`] for every `.html` file\n /// generated by building the book. All of expected files are stored in a\n /// director called \"expected\" in the original book source directory.\n ///\n /// This only works when created with [`BookTest::from_dir`].\n ///\n /// `404.html`, `print.html`, and `toc.html` are not validated. The root\n /// `index.html` is also not validated (since it is often duplicated with\n /// the first chapter). If you need to validate it, call\n /// [`BookTest::check_main_file`] directly.\n #[track_caller]\n pub fn check_all_main_files(&mut self) -> &mut Self {\n if !self.built {\n self.build();\n }\n let book_root = self.dir.join(\"book\");\n let mut files = list_all_files(&book_root);\n files.retain(|file| {\n file.extension().is_some_and(|ext| ext == \"html\")\n && !matches!(\n file.to_str().unwrap(),\n \"index.html\" | \"404.html\" | \"print.html\" | \"toc.html\"\n )\n });\n let expected_path = self\n .original_source\n .as_ref()\n .expect(\"created with BookTest::from_dir\")\n .join(\"expected\");\n let mut expected_list = list_all_files(&expected_path);\n for file in &files {\n let expected = expected_path.join(file);\n let data = snapbox::Data::read_from(&expected, None);\n self.check_main_file(book_root.join(file).to_str().unwrap(), data);\n if let Some(i) = expected_list.iter().position(|p| p == file) {\n expected_list.remove(i);\n }\n }\n // Verify there aren't any unused expected files.\n if !expected_list.is_empty() {\n panic!(\n \"extra expected files found in `{expected_path:?}:\\n\\\n {expected_list:#?}\\n\\\n Verify that these files are no longer needed and delete them.\"\n );\n }\n self\n }\n\n /// Checks the summary contents of `toc.js` against the expected value.\n #[track_caller]\n pub fn check_toc_js(&mut self, expected: impl IntoData) -> &mut Self {\n if !self.built {\n self.build();\n }\n let inner = self.toc_js_html();\n // Would be nice if this were prettified, but a primitive wrapping will do for now.\n let inner = inner.replace(\"><\", \">\\n<\");\n self.assert.eq(inner, expected);\n self\n }\n\n /// Returns the summary contents from `toc.js`.\n #[track_caller]\n pub fn toc_js_html(&self) -> String {\n let toc_path = glob_one(&self.dir, \"book/toc*.js\");\n let actual = read_to_string(&toc_path);\n let inner = actual\n .lines()\n .filter_map(|line| {\n let line = line.trim().strip_prefix(\"this.innerHTML = '\")?;\n let line = line.strip_suffix(\"';\")?;\n Some(line)\n })\n .next()\n .expect(\"should have innerHTML\");\n inner.to_string()\n }\n\n /// Checks that the contents of the given file matches the expected value.\n ///\n /// The path can use glob-style wildcards, but it must match only a single file.\n #[track_caller]\n pub fn check_file(&mut self, path_pattern: &str, expected: impl IntoData) -> &mut Self {\n if !self.built {\n self.build();\n }\n let path = glob_one(&self.dir, path_pattern);\n let actual = read_to_string(&path);\n self.assert.eq(actual, expected);\n self\n }\n\n /// Checks that the given file contains the given [`snapbox::Assert`] pattern somewhere.\n ///\n /// The path can use glob-style wildcards, but it must match only a single file.\n #[track_caller]\n pub fn check_file_contains(&mut self, path_pattern: &str, expected: &str) -> &mut Self {\n if !self.built {\n self.build();\n }\n let path = glob_one(&self.dir, path_pattern);\n let actual = read_to_string(&path);\n let expected = format!(\"...\\n[..]{expected}[..]\\n...\\n\");\n self.assert.eq(actual, expected);\n self\n }\n\n /// Checks that the given file does not contain the given string anywhere.\n ///\n /// Beware that using this is fragile, as it may be unable to catch\n /// regressions (it can't tell the difference between success, or the\n /// string being looked for changed).\n ///\n /// The path can use glob-style wildcards, but it must match only a single file.\n #[track_caller]\n pub fn check_file_doesnt_contain(&mut self, path_pattern: &str, string: &str) -> &mut Self {\n if !self.built {\n self.build();\n }\n let path = glob_one(&self.dir, path_pattern);\n let actual = read_to_string(&path);\n assert!(\n !actual.contains(string),\n \"Unexpectedly found {string:?} in {path:?}\\n\\n{actual}\",\n );\n self\n }\n\n /// Checks that the list of files at the given path matches the given value.\n #[track_caller]\n pub fn check_file_list(&mut self, path: &str, expected: impl IntoData) -> &mut Self {\n let mut all_paths: Vec<_> = walkdir::WalkDir::new(&self.dir.join(path))\n .into_iter()\n // Skip the outer directory.\n .skip(1)\n .map(|e| {\n e.unwrap()\n .into_path()\n .strip_prefix(&self.dir)\n .unwrap()\n .to_str()\n .unwrap()\n .replace('\\\\', \"/\")\n })\n .collect();\n all_paths.sort();\n let actual = all_paths.join(\"\\n\");\n self.assert.eq(actual, expected);\n self\n }\n\n /// Loads an [`MDBook`] from the temp directory.\n pub fn load_book(&self) -> MDBook {\n MDBook::load(&self.dir).unwrap_or_else(|e| panic!(\"book failed to load: {e:?}\"))\n }\n\n /// Builds the book in the temp directory.\n pub fn build(&mut self) -> &mut Self {\n let book = self.load_book();\n book.build()\n .unwrap_or_else(|e| panic!(\"book failed to build: {e:?}\"));\n self.built = true;\n self\n }\n\n /// Runs the `mdbook` binary in the temp directory.\n ///\n /// This runs `mdbook` with the given args. The args are split on spaces\n /// (if you need args with spaces, use the `args` method). The given\n /// callback receives a [`BookCommand`] for you to customize how the\n /// executable is run.\n pub fn run(&mut self, args: &str, f: impl Fn(&mut BookCommand)) -> &mut Self {\n let mut cmd = BookCommand {\n assert: self.assert.clone(),\n dir: self.dir.clone(),\n args: split_args(args),\n env: BTreeMap::new(),\n expect_status: StatusCode::Success,\n expect_stderr_data: None,\n expect_stdout_data: None,\n debug: None,\n };\n f(&mut cmd);\n cmd.run();\n // Ensure that `built` gets set if a build command is used so that all\n // the `check` methods do not overwrite the contents of what was just\n // built.\n if cmd.args.first().map(String::as_str) == Some(\"build\") {\n self.built = true\n }\n self\n }\n\n /// Change a file's contents in the given path.\n pub fn change_file(&mut self, path: impl AsRef, body: &str) -> &mut Self {\n let path = self.dir.join(path);\n fs::write(&path, body).unwrap();\n self\n }\n\n /// Removes a file or directory relative to the test root.\n pub fn rm_r(&mut self, path: impl AsRef) -> &mut Self {\n let path = self.dir.join(path.as_ref());\n let meta = match path.symlink_metadata() {\n Ok(meta) => meta,\n Err(e) => panic!(\"failed to remove {path:?}, could not read: {e:?}\"),\n };\n // There is a race condition between fetching the metadata and\n // actually performing the removal, but we don't care all that much\n // for our tests.\n if meta.is_dir() {\n if let Err(e) = std::fs::remove_dir_all(&path) {\n panic!(\"failed to remove {path:?}: {e:?}\");\n }\n } else if let Err(e) = std::fs::remove_file(&path) {\n panic!(\"failed to remove {path:?}: {e:?}\")\n }\n self\n }\n\n /// Builds a Rust program with the given src.\n ///\n /// The given path should be the path where to output the executable in\n /// the temp directory.\n pub fn rust_program(&mut self, path: &str, src: &str) -> &mut Self {\n let rs = self.dir.join(path).with_extension(\"rs\");\n let parent = rs.parent().unwrap();\n if !parent.exists() {\n fs::create_dir_all(&parent).unwrap();\n }\n fs::write(&rs, src).unwrap();\n let status = std::process::Command::new(\"rustc\")\n .arg(&rs)\n .current_dir(&parent)\n .status()\n .expect(\"rustc should run\");\n assert!(status.success());\n self\n }\n}\n\n/// A builder for preparing to run the `mdbook` executable.\n///\n/// By default, it expects the process to succeed.\npub struct BookCommand {\n pub dir: PathBuf,\n assert: snapbox::Assert,\n args: Vec,\n env: BTreeMap>,\n expect_status: StatusCode,\n expect_stderr_data: Option,\n expect_stdout_data: Option,\n debug: Option,\n}\n\nimpl BookCommand {\n /// Indicates that the process should fail.\n pub fn expect_failure(&mut self) -> &mut Self {\n self.expect_status = StatusCode::Failure;\n self\n }\n\n /// Indicates the process should fail with the given exit code.\n pub fn expect_code(&mut self, code: i32) -> &mut Self {\n self.expect_status = StatusCode::Code(code);\n self\n }\n\n /// Verifies that stderr matches the given value.\n pub fn expect_stderr(&mut self, expected: impl snapbox::IntoData) -> &mut Self {\n self.expect_stderr_data = Some(expected.into_data());\n self\n }\n\n /// Verifies that stdout matches the given value.\n pub fn expect_stdout(&mut self, expected: impl snapbox::IntoData) -> &mut Self {\n self.expect_stdout_data = Some(expected.into_data());\n self\n }\n\n /// Adds arguments to the command to run.\n pub fn args(&mut self, args: &[&str]) -> &mut Self {\n self.args.extend(args.into_iter().map(|t| t.to_string()));\n self\n }\n\n /// Specifies an environment variable to set on the executable.\n pub fn env>(&mut self, key: &str, value: T) -> &mut Self {\n self.env.insert(key.to_string(), Some(value.into()));\n self\n }\n\n /// Sets the directory used for running the command.\n pub fn current_dir>(&mut self, path: S) -> &mut Self {\n self.dir = self.dir.join(path.as_ref());\n self\n }\n\n /// Use this to debug a command.\n ///\n /// Pass the value that you would normally pass to `MDBOOK_LOG`, and this\n /// will enable logging, print the command that runs and its output.\n ///\n /// This will fail if you use it in CI.\n #[allow(unused)]\n pub fn debug(&mut self, value: &str) -> &mut Self {\n if std::env::var_os(\"CI\").is_some() {\n panic!(\"debug is not allowed on CI\");\n }\n self.debug = Some(value.into());\n self\n }\n\n /// Runs the command, and verifies the output.\n fn run(&mut self) {\n let mut cmd = Command::new(env!(\"CARGO_BIN_EXE_mdbook\"));\n cmd.current_dir(&self.dir)\n .args(&self.args)\n .env_remove(\"MDBOOK_LOG\")\n // Don't read the system git config which is out of our control.\n .env(\"GIT_CONFIG_NOSYSTEM\", \"1\")\n .env(\"GIT_CONFIG_GLOBAL\", &self.dir)\n .env(\"GIT_CONFIG_SYSTEM\", &self.dir)\n .env_remove(\"GIT_AUTHOR_EMAIL\")\n .env_remove(\"GIT_AUTHOR_NAME\")\n .env_remove(\"GIT_COMMITTER_EMAIL\")\n .env_remove(\"GIT_COMMITTER_NAME\");\n\n if let Some(debug) = &self.debug {\n cmd.env(\"MDBOOK_LOG\", debug);\n }\n\n for (k, v) in &self.env {\n match v {\n Some(v) => cmd.env(k, v),\n None => cmd.env_remove(k),\n };\n }\n\n if self.debug.is_some() {\n eprintln!(\"running {cmd:#?}\");\n }\n let output = cmd.output().expect(\"mdbook should be runnable\");\n let stdout = std::str::from_utf8(&output.stdout).expect(\"stdout is not utf8\");\n let stderr = std::str::from_utf8(&output.stderr).expect(\"stderr is not utf8\");\n let render_output = || format!(\"\\n--- stdout\\n{stdout}\\n--- stderr\\n{stderr}\");\n match (self.expect_status, output.status.success()) {\n (StatusCode::Success, false) => {\n panic!(\"mdbook failed, but expected success{}\", render_output())\n }\n (StatusCode::Failure, true) => {\n panic!(\"mdbook succeeded, but expected failure{}\", render_output())\n }\n (StatusCode::Code(expected), _) => match output.status.code() {\n Some(actual) => assert_eq!(\n actual, expected,\n \"process exit code did not match as expected\"\n ),\n None => panic!(\"process exited via signal {:?}\", output.status),\n },\n _ => {}\n }\n if self.debug.is_some() {\n eprintln!(\"{}\", render_output());\n }\n self.expect_status = StatusCode::Success; // Reset to default.\n if let Some(expect_stderr_data) = &self.expect_stderr_data {\n if let Err(e) = self.assert.try_eq(\n Some(&\"stderr\"),\n stderr.into_data(),\n expect_stderr_data.clone(),\n ) {\n panic!(\"{e}\");\n }\n }\n if let Some(expect_stdout_data) = &self.expect_stdout_data {\n if let Err(e) = self.assert.try_eq(\n Some(&\"stdout\"),\n stdout.into_data(),\n expect_stdout_data.clone(),\n ) {\n panic!(\"{e}\");\n }\n }\n }\n}\n\nfn split_args(s: &str) -> Vec {\n s.split_whitespace()\n .map(|arg| {\n if arg.contains(&['\"', '\\''][..]) {\n panic!(\"shell-style argument parsing is not supported\");\n }\n String::from(arg)\n })\n .collect()\n}\n\nstatic LITERAL_REDACTIONS: &[(&str, &str)] = &[\n // Unix message for an entity was not found\n (\"[NOT_FOUND]\", \"No such file or directory (os error 2)\"),\n // Windows message for an entity was not found\n (\n \"[NOT_FOUND]\",\n \"The system cannot find the file specified. (os error 2)\",\n ),\n (\n \"[NOT_FOUND]\",\n \"The system cannot find the path specified. (os error 3)\",\n ),\n (\"[NOT_FOUND]\", \"program not found\"),\n // Unix message for exit status\n (\"[EXIT_STATUS]\", \"exit status\"),\n // Windows message for exit status\n (\"[EXIT_STATUS]\", \"exit code\"),\n (\"[TAB]\", \"\\t\"),\n (\"[EXE]\", std::env::consts::EXE_SUFFIX),\n];\n\nfn assert(root: &Path) -> snapbox::Assert {\n let mut subs = snapbox::Redactions::new();\n subs.insert(\"[ROOT]\", root.to_path_buf()).unwrap();\n subs.insert(\"[VERSION]\", mdbook_core::MDBOOK_VERSION)\n .unwrap();\n\n subs.extend(LITERAL_REDACTIONS.into_iter().cloned())\n .unwrap();\n\n snapbox::Assert::new()\n .action_env(snapbox::assert::DEFAULT_ACTION_ENV)\n .redact_with(subs)\n}\n\n/// Helper to read a string from the filesystem.\n#[track_caller]\npub fn read_to_string>(path: P) -> String {\n let path = path.as_ref();\n fs::read_to_string(path).unwrap()\n}\n\n/// Returns the first path from the given glob pattern.\npub fn glob_one>(path: P, pattern: &str) -> PathBuf {\n let path = path.as_ref();\n let mut matches = glob::glob(path.join(pattern).to_str().unwrap()).unwrap();\n let Some(first) = matches.next() else {\n panic!(\"expected at least one file at `{path:?}` with pattern `{pattern}`, found none\");\n };\n let first = first.unwrap();\n if let Some(next) = matches.next() {\n panic!(\n \"expected only one file for pattern `{pattern}` in `{path:?}`, \\\n found `{first:?}` and `{:?}`\",\n next.unwrap()\n );\n }\n first\n}\n\n/// Lists all files at the given directory.\n///\n/// Recursively walks the tree. Paths are relative to the directory.\npub fn list_all_files(dir: &Path) -> Vec {\n walkdir::WalkDir::new(dir)\n .sort_by_file_name()\n .into_iter()\n // Skip the outer directory.\n .skip(1)\n .map(|entry| {\n let entry = entry.unwrap();\n let path = entry.path();\n path.strip_prefix(dir).unwrap().to_path_buf()\n })\n .collect()\n}\n" }, { "path": "tests/testsuite/build/basic_build/README.md", "content": "# Basic book\n\nThis GUI test book is the default book with a single chapter.\n" }, { "path": "tests/testsuite/build/basic_build/book.toml", "content": "[book]\ntitle = \"basic_build\"\n" }, { "path": "tests/testsuite/build/basic_build/src/SUMMARY.md", "content": "# Summary\n\n- [Chapter 1](./chapter_1.md)\n" }, { "path": "tests/testsuite/build/basic_build/src/chapter_1.md", "content": "# Chapter 1\n" }, { "path": "tests/testsuite/build/create_missing/book.toml", "content": "[book]\ntitle = \"create_missing\"\n" }, { "path": "tests/testsuite/build/create_missing/src/SUMMARY.md", "content": "# Summary\n\n- [Chapter 1](./chapter_1.md)\n" }, { "path": "tests/testsuite/build/missing_file/book.toml", "content": "[book]\ntitle = \"missing_file\"\n\n[build]\ncreate-missing = false\n" }, { "path": "tests/testsuite/build/missing_file/src/SUMMARY.md", "content": "# Summary\n\n- [Chapter 1](./chapter_1.md)\n" }, { "path": "tests/testsuite/build/no_reserved_filename/book.toml", "content": "[book]\ntitle = \"no_reserved_filename\"\n" }, { "path": "tests/testsuite/build/no_reserved_filename/src/SUMMARY.md", "content": "# Summary\n\n- [Print](print.md)\n" }, { "path": "tests/testsuite/build/no_reserved_filename/src/print.md", "content": "# Print\n" }, { "path": "tests/testsuite/build.rs", "content": "//! General build tests.\n//!\n//! More specific tests should usually go into a module based on the feature.\n//! This module should just have general build tests, or misc small things.\n\nuse crate::prelude::*;\n\n// Simple smoke test that building works.\n#[test]\nfn basic_build() {\n BookTest::from_dir(\"build/basic_build\").run(\"build\", |cmd| {\n cmd.expect_stderr(str![[r#\"\n INFO Book building has started\n INFO Running the html backend\n INFO HTML book written to `[ROOT]/book`\n\n\"#]]);\n });\n}\n\n// Ensure building fails if `create-missing` is false and one of the files does\n// not exist.\n#[test]\nfn failure_on_missing_file() {\n BookTest::from_dir(\"build/missing_file\").run(\"build\", |cmd| {\n cmd.expect_failure().expect_stderr(str![[r#\"\nERROR failed to read chapter `./chapter_1.md`\n[TAB]Caused by: [NOT_FOUND]\n\n\"#]]);\n });\n}\n\n// Ensure a missing file is created if `create-missing` is true.\n#[test]\nfn create_missing() {\n let test = BookTest::from_dir(\"build/create_missing\");\n assert!(test.dir.join(\"src/SUMMARY.md\").exists());\n assert!(!test.dir.join(\"src/chapter_1.md\").exists());\n test.load_book();\n assert!(test.dir.join(\"src/chapter_1.md\").exists());\n}\n\n// Checks that it fails if the summary has a reserved filename.\n#[test]\nfn no_reserved_filename() {\n BookTest::from_dir(\"build/no_reserved_filename\").run(\"build\", |cmd| {\n cmd.expect_failure().expect_stderr(str![[r#\"\n INFO Book building has started\n INFO Running the html backend\nERROR Rendering failed\n[TAB]Caused by: print.md is reserved for internal use\n\n\"#]]);\n });\n}\n\n// Build without book.toml should be OK.\n#[test]\nfn book_toml_isnt_required() {\n let mut test = BookTest::init(|_| {});\n std::fs::remove_file(test.dir.join(\"book.toml\")).unwrap();\n test.build();\n test.check_main_file(\n \"book/chapter_1.html\",\n str![[r##\"

Chapter 1

\"##]],\n );\n}\n\n// Dest dir relative path behavior.\n#[test]\nfn dest_dir_relative_path() {\n let mut test = BookTest::from_dir(\"build/basic_build\");\n let current_dir = test.dir.join(\"work\");\n std::fs::create_dir_all(¤t_dir).unwrap();\n test.run(\"build\", |cmd| {\n cmd.args(&[\"--dest-dir\", \"foo\", \"..\"])\n .current_dir(¤t_dir)\n .expect_stderr(str![[r#\"\n INFO Book building has started\n INFO Running the html backend\n INFO HTML book written to `[ROOT]/work/foo`\n\n\"#]]);\n });\n assert!(current_dir.join(\"foo/index.html\").exists());\n}\n" }, { "path": "tests/testsuite/cli.rs", "content": "//! Basic tests for mdbook's CLI.\n\nuse crate::prelude::*;\nuse snapbox::file;\n\n// Test with no args.\n#[test]\n#[cfg_attr(\n not(all(feature = \"watch\", feature = \"serve\")),\n ignore = \"needs all features\"\n)]\nfn no_args() {\n BookTest::empty().run(\"\", |cmd| {\n cmd.expect_code(2)\n .expect_stdout(str![[\"\"]])\n .expect_stderr(file![\"cli/no_args.term.svg\"]);\n });\n}\n\n// Help command.\n#[test]\n#[cfg_attr(\n not(all(feature = \"watch\", feature = \"serve\")),\n ignore = \"needs all features\"\n)]\nfn help() {\n BookTest::empty()\n .run(\"help\", |cmd| {\n cmd.expect_stdout(file![\"cli/help.term.svg\"])\n .expect_stderr(str![[\"\"]]);\n })\n .run(\"--help\", |cmd| {\n cmd.expect_stdout(file![\"cli/help.term.svg\"])\n .expect_stderr(str![[\"\"]]);\n });\n}\n" }, { "path": "tests/testsuite/config/empty/book.toml", "content": "" }, { "path": "tests/testsuite/config/empty/src/SUMMARY.md", "content": "# Summary\n\n- [Chapter 1](./chapter_1.md)\n" }, { "path": "tests/testsuite/config/empty/src/chapter_1.md", "content": "# Chapter 1\n" }, { "path": "tests/testsuite/config.rs", "content": "//! Tests for book configuration loading.\n\nuse crate::prelude::*;\n\n// Test that config can load from environment variable.\n#[test]\nfn config_from_env() {\n BookTest::from_dir(\"config/empty\")\n .run(\"build\", |cmd| {\n cmd.env(\"MDBOOK_BOOK__TITLE\", \"Custom env title\");\n })\n .check_file_contains(\n \"book/index.html\",\n \"Chapter 1 - Custom env title\",\n );\n\n // json for some subtable\n //\n}\n\n// Test environment config with JSON.\n#[test]\nfn config_json_from_env() {\n // build table\n BookTest::from_dir(\"config/empty\")\n .run(\"build\", |cmd| {\n cmd.env(\n \"MDBOOK_BOOK\",\n r#\"{\"title\": \"My Awesome Book\", \"authors\": [\"Michael-F-Bryan\"]}\"#,\n );\n })\n .check_file_contains(\n \"book/index.html\",\n \"Chapter 1 - My Awesome Book\",\n );\n\n // book table\n BookTest::from_dir(\"config/empty\")\n .run(\"build\", |cmd| {\n cmd.env(\"MDBOOK_BUILD\", r#\"{\"build-dir\": \"alt\"}\"#);\n })\n .check_file_contains(\"alt/index.html\", \"Chapter 1\");\n}\n\n// Test that a preprocessor receives config set in the environment.\n#[test]\nfn preprocessor_cfg_from_env() {\n let mut test = BookTest::from_dir(\"config/empty\");\n test.rust_program(\n \"cat-to-file\",\n r#\"\n fn main() {\n use std::io::Read;\n let mut s = String::new();\n std::io::stdin().read_to_string(&mut s).unwrap();\n std::fs::write(\"out.txt\", s).unwrap();\n println!(\"{{\\\"items\\\": []}}\");\n }\n \"#,\n )\n .run(\"build\", |cmd| {\n cmd.env(\n \"MDBOOK_PREPROCESSOR__CAT_TO_FILE\",\n r#\"{\"command\":\"./cat-to-file\", \"array\": [1,2,3], \"number\": 123}\"#,\n );\n });\n let out = read_to_string(test.dir.join(\"out.txt\"));\n let (ctx, _book) = mdbook_preprocessor::parse_input(out.as_bytes()).unwrap();\n let cfg: serde_json::Value = ctx.config.get(\"preprocessor.cat-to-file\").unwrap().unwrap();\n assert_eq!(\n cfg,\n serde_json::json!({\n \"command\": \"./cat-to-file\",\n \"array\": [1,2,3],\n \"number\": 123,\n })\n );\n}\n\n// Test that a renderer receives config set in the environment.\n#[test]\nfn output_cfg_from_env() {\n let mut test = BookTest::from_dir(\"config/empty\");\n test.rust_program(\n \"cat-to-file\",\n r#\"\n fn main() {\n use std::io::Read;\n let mut s = String::new();\n std::io::stdin().read_to_string(&mut s).unwrap();\n std::fs::write(\"out.txt\", s).unwrap();\n }\n \"#,\n )\n .run(\"build\", |cmd| {\n cmd.env(\n \"MDBOOK_OUTPUT__CAT_TO_FILE\",\n r#\"{\"command\":\"./cat-to-file\", \"array\": [1,2,3], \"number\": 123}\"#,\n );\n });\n let out = read_to_string(test.dir.join(\"book/out.txt\"));\n let ctx = mdbook_renderer::RenderContext::from_json(out.as_bytes()).unwrap();\n let cfg: serde_json::Value = ctx.config.get(\"output.cat-to-file\").unwrap().unwrap();\n assert_eq!(\n cfg,\n serde_json::json!({\n \"command\": \"./cat-to-file\",\n \"array\": [1,2,3],\n \"number\": 123,\n })\n );\n}\n\n// An invalid key at the top level.\n#[test]\nfn bad_config_top_level() {\n BookTest::init(|_| {})\n .change_file(\"book.toml\", \"foo = 123\")\n .run(\"build\", |cmd| {\n cmd.expect_failure()\n .expect_stdout(str![[\"\"]])\n .expect_stderr(str![[r#\"\nERROR Invalid configuration file\n[TAB]Caused by: TOML parse error at line 1, column 1\n |\n1 | foo = 123\n | ^^^\nunknown field `foo`, expected one of `book`, `build`, `rust`, `output`, `preprocessor`\n\n\n\"#]]);\n });\n}\n\n// An invalid table at the top level.\n#[test]\nfn bad_config_top_level_table() {\n BookTest::init(|_| {})\n .change_file(\n \"book.toml\",\n \"[other]\\n\\\n foo = 123\",\n )\n .run(\"build\", |cmd| {\n cmd.expect_failure()\n .expect_stdout(str![[\"\"]])\n .expect_stderr(str![[r#\"\nERROR Invalid configuration file\n[TAB]Caused by: TOML parse error at line 1, column 2\n |\n1 | [other]\n | ^^^^^\nunknown field `other`, expected one of `book`, `build`, `rust`, `output`, `preprocessor`\n\n\n\"#]]);\n });\n}\n\n// An invalid key in the main book table.\n#[test]\nfn bad_config_in_book_table() {\n BookTest::init(|_| {})\n .change_file(\n \"book.toml\",\n \"[book]\\n\\\n title = \\\"bad-config\\\"\\n\\\n foo = 123\"\n )\n .run(\"build\", |cmd| {\n cmd.expect_failure()\n .expect_stdout(str![[\"\"]])\n .expect_stderr(str![[r#\"\nERROR Invalid configuration file\n[TAB]Caused by: TOML parse error at line 3, column 1\n |\n3 | foo = 123\n | ^^^\nunknown field `foo`, expected one of `title`, `authors`, `description`, `src`, `language`, `text-direction`\n\n\n\"#]]);\n });\n}\n\n// An invalid key in the main rust table.\n#[test]\nfn bad_config_in_rust_table() {\n BookTest::init(|_| {})\n .change_file(\n \"book.toml\",\n \"[rust]\\n\\\n title = \\\"bad-config\\\"\\n\",\n )\n .run(\"build\", |cmd| {\n cmd.expect_failure()\n .expect_stdout(str![[\"\"]])\n .expect_stderr(str![[r#\"\nERROR Invalid configuration file\n[TAB]Caused by: TOML parse error at line 2, column 1\n |\n2 | title = \"bad-config\"\n | ^^^^^\nunknown field `title`, expected `edition`\n\n\n\"#]]);\n });\n}\n\n// An invalid top-level key in the environment.\n#[test]\nfn env_invalid_config_key() {\n BookTest::from_dir(\"config/empty\").run(\"build\", |cmd| {\n cmd.env(\"MDBOOK_FOO\", \"testing\")\n .expect_stdout(str![[\"\"]])\n .expect_stderr(str![[r#\"\n INFO Book building has started\n INFO Running the html backend\n INFO HTML book written to `[ROOT]/book`\n\n\"#]]);\n });\n}\n\n// An invalid value in the environment.\n#[test]\nfn env_invalid_value() {\n BookTest::from_dir(\"config/empty\")\n .run(\"build\", |cmd| {\n cmd.env(\"MDBOOK_BOOK\", r#\"{\"titlez\": \"typo\"}\"#)\n .expect_failure()\n .expect_stdout(str![[\"\"]])\n .expect_stderr(str![[r#\"\nERROR unknown field `titlez`, expected one of `title`, `authors`, `description`, `src`, `language`, `text-direction`\n\n\n\"#]]);\n })\n .run(\"build\", |cmd| {\n cmd.env(\"MDBOOK_BOOK__TITLE\", r#\"{\"looks like obj\": \"abc\"}\"#)\n .expect_failure()\n .expect_stdout(str![[\"\"]])\n .expect_stderr(str![[r#\"\nERROR invalid type: map, expected a string\nin `title`\n\n\n\"#]]);\n })\n // This is not valid JSON, so falls back to be interpreted as a string.\n .run(\"build\", |cmd| {\n cmd.env(\"MDBOOK_BOOK__TITLE\", r#\"{braces}\"#)\n .expect_stdout(str![[\"\"]])\n .expect_stderr(str![[r#\"\n INFO Book building has started\n INFO Running the html backend\n INFO HTML book written to `[ROOT]/book`\n\n\"#]]);\n })\n .check_file_contains(\"book/index.html\", \"Chapter 1 - {braces}\");\n}\n\n// Replacing the entire book table from the environment.\n#[test]\nfn env_entire_book_table() {\n BookTest::init(|_| {})\n .change_file(\n \"book.toml\",\n \"[book]\\n\\\n title = \\\"config title\\\"\\n\\\n \",\n )\n .run(\"build\", |cmd| {\n cmd.env(\"MDBOOK_BOOK\", r#\"{\"description\": \"custom description\"}\"#);\n })\n // The book.toml title is removed.\n .check_file_contains(\"book/index.html\", \"Chapter 1\")\n .check_file_contains(\n \"book/index.html\",\n r#\"\"#,\n );\n}\n\n// Replacing the entire output or preprocessor table from the environment.\n#[test]\nfn env_entire_output_preprocessor_table() {\n BookTest::from_dir(\"config/empty\")\n .rust_program(\n \"mdbook-my-preprocessor\",\n r#\"\n fn main() {\n let mut args = std::env::args().skip(1);\n if args.next().as_deref() == Some(\"supports\") {\n return;\n }\n use std::io::Read;\n let mut s = String::new();\n std::io::stdin().read_to_string(&mut s).unwrap();\n assert!(s.contains(\"custom preprocessor config\"));\n println!(\"{{\\\"items\\\": []}}\");\n }\n \"#,\n )\n .rust_program(\n \"mdbook-my-output\",\n r#\"\n fn main() {\n use std::io::Read;\n let mut s = String::new();\n std::io::stdin().read_to_string(&mut s).unwrap();\n assert!(s.contains(\"custom output config\"));\n eprintln!(\"preprocessor saw custom config\");\n }\n \"#,\n )\n .run(\"build\", |cmd| {\n let mut paths: Vec<_> =\n std::env::split_paths(&std::env::var_os(\"PATH\").unwrap_or_default()).collect();\n paths.push(cmd.dir.clone());\n let path = std::env::join_paths(paths).unwrap().into_string().unwrap();\n\n cmd.env(\n \"MDBOOK_OUTPUT\",\n r#\"{\"my-output\": {\"foo\": \"custom output config\"}}\"#,\n )\n .env(\n \"MDBOOK_PREPROCESSOR\",\n r#\"{\"my-preprocessor\": {\"foo\": \"custom preprocessor config\"}}\"#,\n )\n .env(\"PATH\", path)\n .expect_stdout(str![[\"\"]])\n .expect_stderr(str![[r#\"\n INFO Book building has started\n INFO Running the my-output backend\n INFO Invoking the \"my-output\" renderer\npreprocessor saw custom config\n\n\"#]]);\n })\n // No HTML output\n .check_file_list(\"book\", str![[\"\"]]);\n}\n" }, { "path": "tests/testsuite/includes/all_includes/book.toml", "content": "[book]\ntitle = \"all_includes\"\n" }, { "path": "tests/testsuite/includes/all_includes/src/SUMMARY.md", "content": "# Summary\n\n- [Basic Includes](./includes.md)\n - [Relative Includes](./relative/includes.md)\n- [Recursive Includes](./recursive.md)\n- [Include Anchors](./anchors.md)\n- [Rustdoc Includes](./rustdoc.md)\n- [Playground Includes](./playground.md)\n" }, { "path": "tests/testsuite/includes/all_includes/src/anchors.md", "content": "# Include Anchors\n\n```rust\n{{#include nested-test-with-anchors.rs:myanchor}}\n```\n" }, { "path": "tests/testsuite/includes/all_includes/src/example.rs", "content": "fn main() {\n println!(\"Hello World!\");\n#\n# // You can even hide lines! :D\n# println!(\"I am hidden! Expand the code snippet to see me\");\n}\n" }, { "path": "tests/testsuite/includes/all_includes/src/includes.md", "content": "# Basic Includes\n\n{{#include sample.md}}\n\n" }, { "path": "tests/testsuite/includes/all_includes/src/nested-test-with-anchors.rs", "content": "// This is a test of includes with anchors.\n\n// ANCHOR: myanchor\n// ANCHOR: unendinganchor\nlet x = 1;\n// ANCHOR_END: myanchor\n" }, { "path": "tests/testsuite/includes/all_includes/src/partially-included-test-with-anchors.rs", "content": "fn some_other_function() {\n // ANCHOR: unused-anchor-that-should-be-stripped\n println!(\"unused anchor\");\n // ANCHOR_END: unused-anchor-that-should-be-stripped\n}\n\n// ANCHOR: rustdoc-include-anchor\nfn main() {\n some_other_function();\n}\n// ANCHOR_END: rustdoc-include-anchor\n" }, { "path": "tests/testsuite/includes/all_includes/src/partially-included-test.rs", "content": "fn some_function() {\n println!(\"some function\");\n}\n\nfn main() {\n some_function();\n}\n" }, { "path": "tests/testsuite/includes/all_includes/src/playground.md", "content": "# Playground Includes\n\n{{#playground example.rs}}\n" }, { "path": "tests/testsuite/includes/all_includes/src/recursive.md", "content": "Around the world, around the world\n{{#include recursive.md}}\n" }, { "path": "tests/testsuite/includes/all_includes/src/relative/includes.md", "content": "# Relative Includes\n\n{{#include ../sample.md}}\n" }, { "path": "tests/testsuite/includes/all_includes/src/rustdoc.md", "content": "# Rustdoc Includes\n\n## Rustdoc include adds the rest of the file as hidden\n\n```rust\n{{#rustdoc_include partially-included-test.rs:5:7}}\n```\n\n## Rustdoc include works with anchors too\n\n```rust\n{{#rustdoc_include partially-included-test-with-anchors.rs:rustdoc-include-anchor}}\n```\n" }, { "path": "tests/testsuite/includes/all_includes/src/sample.md", "content": "## Sample\n\nThis is a sample include.\n" }, { "path": "tests/testsuite/includes.rs", "content": "//! Tests for include preprocessor.\n\nuse crate::prelude::*;\n\n// Basic test for #include.\n#[test]\nfn include() {\n BookTest::from_dir(\"includes/all_includes\")\n .check_main_file(\n \"book/includes.html\",\n str![[r##\"\n

Basic Includes

\n

Sample

\n

This is a sample include.

\n\"##]],\n )\n .check_main_file(\n \"book/relative/includes.html\",\n str![[r##\"\n

Relative Includes

\n

Sample

\n

This is a sample include.

\n\"##]],\n );\n}\n\n// Checks for anchored includes.\n#[test]\nfn anchored_include() {\n BookTest::from_dir(\"includes/all_includes\").check_main_file(\n \"book/anchors.html\",\n str![[r##\"\n

Include Anchors

\n
#![allow(unused)]\nfn main() {\nlet x = 1;\n}
\n\"##]],\n );\n}\n\n// Checks behavior of recursive include.\n#[test]\nfn recursive_include() {\n BookTest::from_dir(\"includes/all_includes\")\n .run(\"build\", |cmd| {\n cmd.expect_stderr(str![[r#\"\n INFO Book building has started\nERROR Stack depth exceeded in recursive.md. Check for cyclic includes\n INFO Running the html backend\n INFO HTML book written to `[ROOT]/book`\n\n\"#]]);\n })\n .check_main_file(\n \"book/recursive.html\",\n str![[r#\"\n

Around the world, around the world\nAround the world, around the world\nAround the world, around the world\nAround the world, around the world\nAround the world, around the world\nAround the world, around the world\nAround the world, around the world\nAround the world, around the world\nAround the world, around the world\nAround the world, around the world\nAround the world, around the world

\n\"#]],\n );\n}\n\n// Checks the behavior of `{{#playground}}` include.\n#[test]\nfn playground_include() {\n BookTest::from_dir(\"includes/all_includes\")\n .check_main_file(\"book/playground.html\",\n str![[r##\"\n

Playground Includes

\n
fn main() {\n    println!(\"Hello World!\");\n\n   // You can even hide lines! :D\n  println!(\"I am hidden! Expand the code snippet to see me\");\n}
\n\"##]]);\n}\n\n// Checks the behavior of `{{#rustdoc_include}}`.\n#[test]\nfn rustdoc_include() {\n BookTest::from_dir(\"includes/all_includes\")\n .check_main_file(\"book/rustdoc.html\",\n str![[r##\"\n

Rustdoc Includes

\n

Rustdoc include adds the rest of the file as hidden

\n
fn some_function() {\n    println!(\"some function\");\n}\n\nfn main() {\n    some_function();\n}
\n

Rustdoc include works with anchors too

\n
fn some_other_function() {\n    println!(\"unused anchor\");\n}\n\nfn main() {\n    some_other_function();\n}
\n\"##]]);\n}\n" }, { "path": "tests/testsuite/index/basic_readme/book.toml", "content": "[book]\ntitle = \"basic_readme\"\n" }, { "path": "tests/testsuite/index/basic_readme/src/README.md", "content": "# Intro\n" }, { "path": "tests/testsuite/index/basic_readme/src/SUMMARY.md", "content": "# Summary\n\n[Intro](./README.md)\n\n- [First](first/README)\n- [Second](second/Readme.md)\n" }, { "path": "tests/testsuite/index/basic_readme/src/first/README", "content": "# First\n" }, { "path": "tests/testsuite/index/basic_readme/src/second/Readme.md", "content": "# Second\n" }, { "path": "tests/testsuite/index.rs", "content": "//! Tests for the index preprocessor.\n\nuse crate::prelude::*;\n\n// Checks basic README to index.html conversion.\n#[test]\nfn readme_to_index() {\n let mut test = BookTest::from_dir(\"index/basic_readme\");\n test.check_main_file(\n \"book/index.html\",\n str![[r##\"

Intro

\"##]],\n )\n .check_main_file(\n \"book/first/index.html\",\n str![[r##\"

First

\"##]],\n )\n .check_main_file(\n \"book/second/index.html\",\n str![[r##\"

Second

\"##]],\n )\n .check_toc_js(str![[r#\"\n
    \n
  1. \n\nIntro\n\n
    2. \n
  2. \n\n\n1. First\n\n
    3. \n
  3. \n\n\n2. Second\n\n
    4. \n
\n\"#]]);\n assert!(test.dir.join(\"book/index.html\").exists());\n assert!(!test.dir.join(\"book/README.html\").exists());\n}\n" }, { "path": "tests/testsuite/init/init_from_summary/src/SUMMARY.md", "content": "# Summary\n\n[intro](intro.md)\n\n- [First chapter](first.md)\n\n[outro](outro.md)\n\n" }, { "path": "tests/testsuite/init.rs", "content": "//! Tests for `mdbook init`.\n\nuse crate::prelude::*;\nuse mdbook_core::config::Config;\nuse mdbook_driver::MDBook;\nuse std::path::PathBuf;\n\n// Tests \"init\" with no args.\n#[test]\nfn basic_init() {\n let mut test = BookTest::empty();\n test.run(\"init\", |cmd| {\n cmd.expect_stdout(str![[r#\"\n\nDo you want a .gitignore to be created? (y/n)\nWhat title would you like to give the book? \n\nAll done, no errors...\n\n\"#]])\n .expect_stderr(str![[r#\"\n INFO Creating a new book with stub content\n\n\"#]]);\n })\n .check_file(\n \"book.toml\",\n str![[r#\"\n[book]\nauthors = []\nlanguage = \"en\"\n\n\"#]],\n )\n .check_file(\n \"src/SUMMARY.md\",\n str![[r#\"\n# Summary\n\n- [Chapter 1](./chapter_1.md)\n\n\"#]],\n )\n .check_file(\n \"src/chapter_1.md\",\n str![[r#\"\n# Chapter 1\n\n\"#]],\n )\n .check_main_file(\n \"book/chapter_1.html\",\n str![[r##\"

Chapter 1

\"##]],\n );\n assert!(!test.dir.join(\".gitignore\").exists());\n assert!(test.dir.join(\"book\").exists());\n}\n\n// Test init via API. This does a little less than the CLI does.\n#[test]\nfn init_api() {\n let mut test = BookTest::empty();\n MDBook::init(&test.dir).build().unwrap();\n test.check_file_list(\n \".\",\n str![[r#\"\nbook\nbook.toml\nsrc\nsrc/SUMMARY.md\nsrc/chapter_1.md\n\"#]],\n );\n}\n\n// Run `mdbook init` with `--force` to skip the confirmation prompts\n#[test]\nfn init_force() {\n let mut test = BookTest::empty();\n test.run(\"init --force\", |cmd| {\n cmd.expect_stdout(str![[r#\"\n\nAll done, no errors...\n\n\"#]])\n .expect_stderr(str![[r#\"\n INFO Creating a new book with stub content\n\n\"#]]);\n })\n .check_file(\n \"book.toml\",\n str![[r#\"\n[book]\nauthors = []\nlanguage = \"en\"\n\n\"#]],\n );\n assert!(!test.dir.join(\".gitignore\").exists());\n}\n\n// Run `mdbook init` with `--title` without git config.\n//\n// Regression test for https://github.com/rust-lang/mdBook/issues/2485\n#[test]\nfn no_git_config_with_title() {\n let mut test = BookTest::empty();\n test.run(\"init\", |cmd| {\n cmd.expect_stdout(str![[r#\"\n\nDo you want a .gitignore to be created? (y/n)\n\nAll done, no errors...\n\n\"#]])\n .expect_stderr(str![[r#\"\n INFO Creating a new book with stub content\n\n\"#]])\n .args(&[\"--title\", \"Example title\"]);\n })\n .check_file(\n \"book.toml\",\n str![[r#\"\n[book]\ntitle = \"Example title\"\nauthors = []\nlanguage = \"en\"\n\n\"#]],\n );\n assert!(!test.dir.join(\".gitignore\").exists());\n}\n\n// Run `mdbook init` in a directory containing a SUMMARY.md should create the\n// files listed in the summary.\n#[test]\nfn init_from_summary() {\n BookTest::from_dir(\"init/init_from_summary\")\n .run(\"init\", |_| {})\n .check_file(\n \"src/intro.md\",\n str![[r#\"\n# intro\n\n\"#]],\n )\n .check_file(\n \"src/first.md\",\n str![[r#\"\n# First chapter\n\n\"#]],\n )\n .check_file(\n \"src/outro.md\",\n str![[r#\"\n# outro\n\n\"#]],\n );\n}\n\n// Set some custom arguments for where to place the source and destination\n// files, then call `mdbook init`.\n#[test]\nfn init_with_custom_book_and_src_locations() {\n let mut test = BookTest::empty();\n let mut cfg = Config::default();\n cfg.book.src = PathBuf::from(\"in\");\n cfg.build.build_dir = PathBuf::from(\"out\");\n MDBook::init(&test.dir).with_config(cfg).build().unwrap();\n test.check_file(\n \"book.toml\",\n str![[r#\"\n[book]\nauthors = []\nsrc = \"in\"\nlanguage = \"en\"\n\n[build]\nbuild-dir = \"out\"\ncreate-missing = true\nuse-default-preprocessors = true\nextra-watch-dirs = []\n\n\"#]],\n )\n .check_file(\n \"in/SUMMARY.md\",\n str![[r#\"\n# Summary\n\n- [Chapter 1](./chapter_1.md)\n\n\"#]],\n )\n .check_file(\n \"in/chapter_1.md\",\n str![[r#\"\n# Chapter 1\n\n\"#]],\n );\n assert!(test.dir.join(\"out\").exists());\n}\n\n// Copies the theme into the initialized directory.\n#[test]\nfn copy_theme() {\n BookTest::empty()\n .run(\"init --theme\", |_| {})\n .check_file_list(\n \".\",\n str![[r#\"\nbook\nbook.toml\nsrc\nsrc/SUMMARY.md\nsrc/chapter_1.md\ntheme\ntheme/book.js\ntheme/css\ntheme/css/chrome.css\ntheme/css/general.css\ntheme/css/print.css\ntheme/css/variables.css\ntheme/favicon.png\ntheme/favicon.svg\ntheme/fonts\ntheme/fonts/OPEN-SANS-LICENSE.txt\ntheme/fonts/SOURCE-CODE-PRO-LICENSE.txt\ntheme/fonts/fonts.css\ntheme/fonts/open-sans-v17-all-charsets-300.woff2\ntheme/fonts/open-sans-v17-all-charsets-300italic.woff2\ntheme/fonts/open-sans-v17-all-charsets-600.woff2\ntheme/fonts/open-sans-v17-all-charsets-600italic.woff2\ntheme/fonts/open-sans-v17-all-charsets-700.woff2\ntheme/fonts/open-sans-v17-all-charsets-700italic.woff2\ntheme/fonts/open-sans-v17-all-charsets-800.woff2\ntheme/fonts/open-sans-v17-all-charsets-800italic.woff2\ntheme/fonts/open-sans-v17-all-charsets-italic.woff2\ntheme/fonts/open-sans-v17-all-charsets-regular.woff2\ntheme/fonts/source-code-pro-v11-all-charsets-500.woff2\ntheme/highlight.css\ntheme/highlight.js\ntheme/index.hbs\n\"#]],\n );\n}\n" }, { "path": "tests/testsuite/main.rs", "content": "//! Main testsuite for exercising all functionality of mdBook.\n//!\n//! See README.md for documentation.\n\n#![allow(unreachable_pub, reason = \"not needed in an integration test crate\")]\n\nmod book_test;\nmod build;\nmod cli;\nmod config;\nmod includes;\nmod index;\nmod init;\nmod markdown;\nmod playground;\nmod preprocessor;\nmod print;\nmod redirects;\nmod renderer;\nmod rendering;\n#[cfg(feature = \"search\")]\nmod search;\nmod test;\nmod theme;\nmod toc;\n\nmod prelude {\n pub use crate::book_test::{BookTest, glob_one, read_to_string};\n pub use snapbox::str;\n}\n" }, { "path": "tests/testsuite/markdown/admonitions/book.toml", "content": "[book]\ntitle = \"admonitions\"\n" }, { "path": "tests/testsuite/markdown/admonitions/expected/admonitions.html", "content": "

Admonitions

\n
\n

Note

\n

This is a note.

\n

There are multiple paragraphs.

\n
\n
\n

Tip

\n

This is a tip.

\n
\n
\n

Important

\n

This is important.

\n
\n
\n

Warning

\n

This is a warning.

\n
\n
\n

Caution

\n

This is a caution.

\n
\n
\n

[!UNKNOWN]\nThis is an unknown tag.

\n
\n
\n

Important

\n

This is an important admonition.

\n
\n

Note

\n

This nested note should have its own color.

\n
\n
" }, { "path": "tests/testsuite/markdown/admonitions/expected_disabled/admonitions.html", "content": "

Admonitions

\n
\n

[!NOTE]\nThis is a note.

\n

There are multiple paragraphs.

\n
\n
\n

[!TIP]\nThis is a tip.

\n
\n
\n

[!IMPORTANT]\nThis is important.

\n
\n
\n

[!WARNING]\nThis is a warning.

\n
\n
\n

[!CAUTION]\nThis is a caution.

\n
\n
\n

[!UNKNOWN]\nThis is an unknown tag.

\n
\n
\n

[!IMPORTANT]\nThis is an important admonition.

\n
\n

[!NOTE]\nThis nested note should have its own color.

\n
\n
" }, { "path": "tests/testsuite/markdown/admonitions/src/SUMMARY.md", "content": "# Summary\n\n- [Admonitions](./admonitions.md)\n" }, { "path": "tests/testsuite/markdown/admonitions/src/admonitions.md", "content": "# Admonitions\n\n> [!NOTE]\n> This is a note.\n>\n> There are multiple paragraphs.\n\n> [!TIP]\n> This is a tip.\n\n> [!IMPORTANT]\n> This is important.\n\n> [!WARNING]\n> This is a warning.\n\n> [!CAUTION]\n> This is a caution.\n\n> [!UNKNOWN]\n> This is an unknown tag.\n\n> [!IMPORTANT]\n> This is an important admonition.\n>\n> > [!NOTE]\n> > This nested note should have its own color.\n" }, { "path": "tests/testsuite/markdown/basic_markdown/book.toml", "content": "[book]\ntitle = \"basic_markdown\"\n" }, { "path": "tests/testsuite/markdown/basic_markdown/expected/blank.html", "content": "" }, { "path": "tests/testsuite/markdown/basic_markdown/expected/blockquotes.html", "content": "

Blockquotes

\n

Empty:

\n
\n

Normal:

\n
\n

foo\nbar

\n
\n

Contains code block:

\n
\n
#![allow(unused)]\nfn main() {\nlet x = 1;\n}
\n
\n

Random stuff:

\n
\n

And now,

\n

Let us introduce\nAll kinds of

\n
    \n
  • tags
    • \n
  • etc
    • \n
  • stuff
    • \n
\n
    \n
  1. \n

    In

    \n
    2. \n
  2. \n

    The

    \n
    3. \n
  3. \n

    blockquote

    \n
    \n

    cause we can

    \n
    \n

    Cause we can

    \n
    \n
    \n
    4. \n
\n
" }, { "path": "tests/testsuite/markdown/basic_markdown/expected/code-blocks.html", "content": "

Code blocks

\n
This is a codeblock\n
\n
#![allow(unused)]\nfn main() {\n// This links to a playpen\n}
\n
# This is an editable codeblock\n
\n
Text with different classes.\n
\n
Indented\ncode\nblock.\n
\n
#![allow(unused)]\nfn main() {\nlet x = 1;\n}
\n
fn main() {\n    println!(\"hello\");\n}
" }, { "path": "tests/testsuite/markdown/basic_markdown/expected/html.html", "content": "

Inline HTML

\n

Comments

\n\n\n

Void elements

\n\n \"alt\n\n

Line
break

\n

Wordbreak

\n\n \n \n \n \n
\n\n

\n

Rule:

\n
\n\n\n\n

\n\n

Blocks

\n
\nA block HTML element trying to do *markup*.\n
\n\n
\n

A block HTML with spaces that cause it to be interleaved with markdown.

\n
\n\n

Scripts

\n\n\n\n

Style

\n\n\n

Manual headers

\n

My Header

\n\n

Another header

" }, { "path": "tests/testsuite/markdown/basic_markdown/expected/images.html", "content": "

Images

\n

\"Image

\n

\"Image

" }, { "path": "tests/testsuite/markdown/basic_markdown/expected/inlines.html", "content": "

Inlines

\n

emphasis bold bold emphasis

\n

Some inline code.

\n

Hard
break

\n

Invisible hard
break

\n

[escaped] <html> *here*

" }, { "path": "tests/testsuite/markdown/basic_markdown/expected/links.html", "content": "

Links

\n" }, { "path": "tests/testsuite/markdown/basic_markdown/expected/lists.html", "content": "

Lists

\n
    \n
  1. A
    2. \n
  2. Normal
    3. \n
  3. Ordered
    4. \n
  4. List
    5. \n
\n
\n
    \n
  1. A\n
      \n
    1. Nested
      2. \n
    2. List
      3. \n
    \n
    2. \n
  2. But
    3. \n
  3. Still
    4. \n
  4. Normal
    5. \n
\n
\n
    \n
  1. Start list
    2. \n
  2. with a different number.
    3. \n
\n
\n
    \n
  • An
    • \n
  • Unordered
    • \n
  • Normal
    • \n
  • List
    • \n
\n
\n
    \n
  • Nested\n
      \n
    • Unordered
      • \n
    \n
    • \n
  • List
    • \n
\n
\n
    \n
  • This\n
      \n
    1. Is
      2. \n
    2. Normal
      3. \n
    \n
    • \n
  • ?!
    • \n
" }, { "path": "tests/testsuite/markdown/basic_markdown/expected/svg.html", "content": "

SVG

\n\n\n\n\nSVG\n" }, { "path": "tests/testsuite/markdown/basic_markdown/src/SUMMARY.md", "content": "# Summary\n\n- [Blank](./blank.md)\n- [Blockquotes](./blockquotes.md)\n- [Code blocks](./code-blocks.md)\n- [Lists](./lists.md)\n- [Inlines](./inlines.md)\n- [Links](./links.md)\n- [Images](./images.md)\n- [HTML](./html.md)\n- [SVG](./svg.md)\n" }, { "path": "tests/testsuite/markdown/basic_markdown/src/blank.md", "content": "" }, { "path": "tests/testsuite/markdown/basic_markdown/src/blockquotes.md", "content": "# Blockquotes\n\nEmpty:\n>\n\nNormal:\n> foo\n> bar\n\nContains code block:\n> ```rust\n> let x = 1;\n> ```\n\nRandom stuff:\n> ### And now,\n>\n> **Let us _introduce_**\n> All kinds of\n>\n> - tags\n> - etc\n> - stuff\n>\n> 1. In\n> 2. The\n> 3. blockquote\n>\n> > cause we can\n> >\n> > > Cause we can\n" }, { "path": "tests/testsuite/markdown/basic_markdown/src/code-blocks.md", "content": "# Code blocks\n\n```\nThis is a codeblock\n```\n\n```rust\n// This links to a playpen\n```\n\n```bash,editable\n# This is an editable codeblock\n```\n\n```text cls1,,cls2\tcls3\nText with different classes.\n```\n\n Indented\n code\n block.\n\n```rust,edition2021\nlet x = 1;\n```\n\n```rust\nfn main() {\n println!(\"hello\");\n}\n```\n" }, { "path": "tests/testsuite/markdown/basic_markdown/src/html.md", "content": "# Inline HTML\n\n## Comments\n\n\n\n\n\n## Void elements\n\n\n \"alt\n\n\nLine
break\n\nWordbreak\n\n\n \n \n \n \n
\n\n\n\nRule:\n
\n\n\n\n\n\n\n\n\n\n\n\n## Blocks\n\n
\nA block HTML element trying to do *markup*.\n
\n\n
\n\nA block HTML with spaces that **cause** it to be interleaved with markdown.\n\n
\n\n## Scripts\n\n\n\n\n\n\n\n## Style\n\n\n\n\n\n## Manual headers\n\n

My Header

\n\n

Another header

\n" }, { "path": "tests/testsuite/markdown/basic_markdown/src/images.md", "content": "# Images\n\n![Image *\"alt\"* & \\\"\n `\"text\" & `\n [url](/foo)\n html\n ---\n hard\\\n break\n](https://rust-lang.org/logos/rust-logo-256x256.png)\n\n![Image with title](https://rust-lang.org/logos/rust-logo-256x256.png \"Some title\")\n" }, { "path": "tests/testsuite/markdown/basic_markdown/src/inlines.md", "content": "# Inlines\n\n*emphasis* **bold** **_bold emphasis_**\n\nSome `inline code`.\n\nHard\\\nbreak\n\nInvisible hard \nbreak\n\n\\[escaped] \\ \\*here*\n" }, { "path": "tests/testsuite/markdown/basic_markdown/src/links.md", "content": "# Links\n\n- [Inline](https://example.com/inline)\n- [Collapsed]\n- [Emtpy reference][]\n- [Specific reference][specific]\n- \n- \n- [Titled](https://example.com/title \"with title\")\n- [Broken collapsed]\n- [Broken reference][missing]\n- [Markdown link](path/foo.md)\n- [Markdown link anchor](path/foo.md#anchor)\n- [Link anchor](#anchor)\n- [With md in anchor](path.html#phantomdata)\n\n[collapsed]: https://example.com/collapsed\n[specific]: https://example.com/specific\n" }, { "path": "tests/testsuite/markdown/basic_markdown/src/lists.md", "content": "# Lists\n\n1. A\n2. Normal\n3. Ordered\n4. List\n\n---\n\n1. A\n 1. Nested\n 2. List\n2. But\n3. Still\n4. Normal\n\n---\n\n7. Start list\n7. with a different number.\n\n---\n\n- An\n- Unordered\n- Normal\n- List\n\n---\n\n- Nested\n - Unordered\n- List\n\n---\n\n- This\n 1. Is\n 2. Normal\n- ?!\n" }, { "path": "tests/testsuite/markdown/basic_markdown/src/svg.md", "content": "# SVG\n\n\n\n\n\nSVG\n\n\n" }, { "path": "tests/testsuite/markdown/custom_header_attributes/book.toml", "content": "[book]\ntitle = \"custom_header_attributes\"\n" }, { "path": "tests/testsuite/markdown/custom_header_attributes/src/SUMMARY.md", "content": "# Summary\n\n- [Heading Attributes](./custom_header_attributes.md)\n" }, { "path": "tests/testsuite/markdown/custom_header_attributes/src/custom_header_attributes.md", "content": "# Heading Attributes {#attrs}\n\n## Heading with classes {.class1 .class2}\n\n## Heading with id and classes {#both .class1 .class2}\n\n## Heading with attribute {.myclass1 myattr #myh3 otherattr=value .myclass2}\n" }, { "path": "tests/testsuite/markdown/definition_lists/book.toml", "content": "[book]\ntitle = \"definition_lists\"\n" }, { "path": "tests/testsuite/markdown/definition_lists/expected/definition_lists.html", "content": "

Definition Lists

\n
\n
apple
\n
red fruit
\n
orange
\n
orange fruit
\n
apple
\n
red fruit
\n
computer company
\n
orange
\n
orange fruit
\n
telecom company
\n
term
\n
\n
    \n
  1. \n

    Para one

    \n

    Para two

    \n
    2. \n
\n
\n
\n

Term with link

\n
\n
apple
\n
red fruit
\n
\n

Multi-line term

\n
\n
a\nb
c
\n
\n

foo

\n
\n
\n

Nested

\n
\n
level one
\n
\n
\n
l1\nlevel two
\n
\n
\n
l2\nlevel three
\n
l3
\n
\n
\n
\n
\n
level one
\n
l1
\n
\n

Loose

\n
\n
apple
\n
\n

red fruit

\n
\n
\n

computer company

\n
\n
orange
\n
\n

orange fruit

\n
\n
" }, { "path": "tests/testsuite/markdown/definition_lists/expected/html_definition_lists.html", "content": "

HTML definition lists

\n

Test for definition lists manually written in HTML.

\n
\n \n
Some tag
\n\n \n
Some defintion
\n\n \n
Another definition
\n\n \n
A definition.
\n\n
" }, { "path": "tests/testsuite/markdown/definition_lists/expected_disabled/definition_lists.html", "content": "

Definition Lists

\n

apple\n: red fruit

\n

orange\n: orange fruit

\n

apple\n: red fruit\n: computer company

\n

orange\n: orange fruit\n: telecom company

\n

term\n: 1. Para one

\n
   Para two\n
\n

Term with link

\n

apple\n: red fruit

\n

Multi-line term

\n

a\nb
c

\n

: foo

\n

Nested

\n

level one\n: l1\nlevel two\n: l2\nlevel three\n: l3

\n

level one\n: l1

\n

Loose

\n

apple

\n

: red fruit\n: computer company

\n

orange

\n

: orange fruit

" }, { "path": "tests/testsuite/markdown/definition_lists/expected_disabled/html_definition_lists.html", "content": "

HTML definition lists

\n

Test for definition lists manually written in HTML.

\n
\n \n
Some tag
\n\n \n
Some defintion
\n\n \n
Another definition
\n\n \n
A definition.
\n\n
" }, { "path": "tests/testsuite/markdown/definition_lists/src/SUMMARY.md", "content": "# Summary\n\n- [Definition lists](./definition_lists.md)\n- [HTML definition lists](./html_definition_lists.md)\n" }, { "path": "tests/testsuite/markdown/definition_lists/src/definition_lists.md", "content": "# Definition Lists\n\napple\n: red fruit\n\norange\n: orange fruit\n\napple\n: red fruit\n: computer company\n\norange\n: orange fruit\n: telecom company\n\nterm\n: 1. Para one\n\n Para two\n\n## Term with link\n\n[apple](some-page.md#apple)\n : red fruit\n\n## Multi-line term\n\na\nb\\\nc\n\n: foo\n\n## Nested\n\nlevel one\n: l1\n level two\n : l2\n level three\n : l3\n\nlevel one\n: l1\n\n## Loose\n\napple\n\n: red fruit\n: computer company\n\norange\n\n: orange fruit\n" }, { "path": "tests/testsuite/markdown/definition_lists/src/html_definition_lists.md", "content": "# HTML definition lists\n\nTest for definition lists manually written in HTML.\n\n
\n
Some tag
\n
Some defintion
\n
Another definition
\n
A definition.
\n
\n" }, { "path": "tests/testsuite/markdown/footnotes/expected/footnotes.html", "content": "

Footnote tests

\n

Footnote example1, or with a word2.

\n

There are multiple references to word2.

\n

Footnote without a paragraph3

\n

Footnote with multiple paragraphs4

\n

Footnote name with wacky characters5

\n

Testing when referring to something earlier.6

\n

Footnote that is defined multiple times.7

\n

And another8 that references the duplicate again.7

\n

Multiple footnotes in a row.9 10 11

\n
\n
    \n
  1. \n

    This is a footnote. ↩ ↩2

    \n
    2. \n
  2. \n

    A longer footnote.\nWith multiple lines. Link to other.\nWith a reference inside.1 ↩ ↩2

    \n
    3. \n
  3. \n
      \n
    1. Item one\n
        \n
      1. Sub-item
        2. \n
      \n
      2. \n
    2. Item two
      3. \n
    \n ↩
    4. \n
  4. \n

    One

    \n

    Two

    \n

    Three ↩

    \n
    5. \n
  5. \n

    Testing footnote id with special characters. ↩

    \n
    6. \n
  6. \n

    This is defined before it is referred to. ↩

    \n
    7. \n
  7. \n

    This is the first definition of the footnote with tag multiple-definitions ↩ ↩2

    \n
    8. \n
  8. \n

    Footnote between duplicates. ↩

    \n
    9. \n
  9. \n

    Footnote 1 ↩

    \n
    10. \n
  10. \n

    Footnote 2 ↩

    \n
    11. \n
  11. \n

    Footnote 3 ↩

    \n
    12. \n
" }, { "path": "tests/testsuite/markdown/footnotes/src/SUMMARY.md", "content": "- [Footnotes](footnotes.md)\n" }, { "path": "tests/testsuite/markdown/footnotes/src/footnotes.md", "content": "# Footnote tests\n\nFootnote example[^1], or with a word[^word].\n\n[^1]: This is a footnote.\n\n[^word]: A longer footnote.\n With multiple lines. [Link to other](other.md).\n With a reference inside.[^1]\n\nThere are multiple references to word[^word].\n\nFootnote without a paragraph[^para]\n\n[^para]:\n 1. Item one\n 1. Sub-item\n 2. Item two\n\nFootnote with multiple paragraphs[^multiple]\n\n[^define-before-use]: This is defined before it is referred to.\n\n[^multiple]:\n One\n\n Two\n\n Three\n\n[^unused]: This footnote is defined by not used.\n\nFootnote name with wacky characters[^\"wacky\"]\n\n[^\"wacky\"]: Testing footnote id with special characters.\n\nTesting when referring to something earlier.[^define-before-use]\n\nFootnote that is defined multiple times.[^multiple-definitions]\n\n[^multiple-definitions]: This is the first definition of the footnote with tag multiple-definitions\n\nAnd another[^in-between] that references the duplicate again.[^multiple-definitions]\n\n[^in-between]: Footnote between duplicates.\n\n[^multiple-definitions]: This is the second definition of the footnote with tag multiple-definitions\n\nMultiple footnotes in a row.[^a][^b][^c]\n\n[^a]: Footnote 1\n[^b]: Footnote 2\n[^c]: Footnote 3\n" }, { "path": "tests/testsuite/markdown/smart_punctuation/src/SUMMARY.md", "content": "- [Smart Punctuation](smart_punctuation.md)\n" }, { "path": "tests/testsuite/markdown/smart_punctuation/src/smart_punctuation.md", "content": "# Smart Punctuation\n\n- En dash: --\n- Em dash: ---\n- Ellipsis: ...\n- Double quote: \"quote\"\n- Single quote: 'quote'\n- Quote in `\"code\"`\n\n```\n\"quoted\"\n```\n" }, { "path": "tests/testsuite/markdown/strikethrough/src/SUMMARY.md", "content": "- [Strikethrough](strikethrough.md)\n" }, { "path": "tests/testsuite/markdown/strikethrough/src/strikethrough.md", "content": "# Strikethrough\n\n~~strikethrough example~~\n\n" }, { "path": "tests/testsuite/markdown/tables/src/SUMMARY.md", "content": "- [Tables](tables.md)\n" }, { "path": "tests/testsuite/markdown/tables/src/tables.md", "content": "# Tables\n\n| foo | bar |\n| --- | --- |\n| baz | bim |\n| Backslash in code | `\\` |\n| Double back in code | `\\\\` |\n| Pipe in code | `\\|` |\n| Pipe in code2 | `test \\| inside` |\n\n| Neither | Left | Center | Right |\n|---------|:-----|:------:|------:|\n| one | two | three | four |\n" }, { "path": "tests/testsuite/markdown/tasklists/src/SUMMARY.md", "content": "- [Tasklists](tasklists.md)\n" }, { "path": "tests/testsuite/markdown/tasklists/src/tasklists.md", "content": "## Tasklisks\n\n- [X] Apples\n- [X] Broccoli\n- [ ] Carrots\n" }, { "path": "tests/testsuite/markdown.rs", "content": "//! Tests for special markdown rendering.\n\nuse crate::prelude::*;\nuse snapbox::file;\n\n// Checks custom header id and classes.\n#[test]\nfn custom_header_attributes() {\n BookTest::from_dir(\"markdown/custom_header_attributes\")\n .check_main_file(\"book/custom_header_attributes.html\", str![[r##\"\n

Heading Attributes

\n

Heading with classes

\n

Heading with id and classes

\n

Heading with attribute

\n\"##]]);\n}\n\n// Test for a variety of footnote renderings.\n#[test]\nfn footnotes() {\n BookTest::from_dir(\"markdown/footnotes\")\n .run(\"build\", |cmd| {\n cmd.expect_stderr(str![[r#\"\n INFO Book building has started\n INFO Running the html backend\n WARN footnote `multiple-definitions` in footnotes.md defined multiple times - not updating to new definition\n WARN footnote `unused` in `footnotes.md` is defined but not referenced\n INFO HTML book written to `[ROOT]/book`\n\n\"#]]);\n })\n .check_main_file(\n \"book/footnotes.html\",\n file![\"markdown/footnotes/expected/footnotes.html\"],\n );\n}\n\n// Basic table test.\n#[test]\nfn tables() {\n BookTest::from_dir(\"markdown/tables\").check_main_file(\n \"book/tables.html\",\n str![[r##\"\n

Tables

\n
\n\n\n\n\n\n\n\n\n\n\n\n
foobar
bazbim
Backslash in code/
Double back in code//
Pipe in code|
Pipe in code2test | inside
\n
\n
\n\n\n\n\n\n\n\n
NeitherLeftCenterRight
onetwothreefour
\n
\n\"##]],\n );\n}\n\n// Strikethrough test.\n#[test]\nfn strikethrough() {\n BookTest::from_dir(\"markdown/strikethrough\").check_main_file(\n \"book/strikethrough.html\",\n str![[r##\"\n

Strikethrough

\n

strikethrough example

\n\"##]],\n );\n}\n\n// Tasklist test.\n#[test]\nfn tasklists() {\n BookTest::from_dir(\"markdown/tasklists\").check_main_file(\n \"book/tasklists.html\",\n str![[r##\"\n

Tasklisks

\n
    \n
  • Apples
    • \n
  • Broccoli
    • \n
  • Carrots
    • \n
\n\"##]],\n );\n}\n\n// Smart punctuation test.\n#[test]\nfn smart_punctuation() {\n BookTest::from_dir(\"markdown/smart_punctuation\")\n // Default is on.\n .check_main_file(\n \"book/smart_punctuation.html\",\n str![[r##\"\n

Smart Punctuation

\n
    \n
  • En dash: –
    • \n
  • Em dash: —
    • \n
  • Ellipsis: …
    • \n
  • Double quote: “quote”
    • \n
  • Single quote: ‘quote’
    • \n
  • Quote in \"code\"
    • \n
\n
\"quoted\"\n
\n\"##]],\n )\n .run(\"build\", |cmd| {\n cmd.env(\"MDBOOK_OUTPUT__HTML__SMART_PUNCTUATION\", \"false\");\n })\n .check_main_file(\n \"book/smart_punctuation.html\",\n str![[r##\"\n

Smart Punctuation

\n
    \n
  • En dash: --
    • \n
  • Em dash: ---
    • \n
  • Ellipsis: ...
    • \n
  • Double quote: \"quote\"
    • \n
  • Single quote: 'quote'
    • \n
  • Quote in \"code\"
    • \n
\n
\"quoted\"\n
\n\"##]],\n );\n}\n\n// Basic markdown syntax.\n// This doesn't try to cover the commonmark test suite, but maybe it could some day?\n#[test]\nfn basic_markdown() {\n BookTest::from_dir(\"markdown/basic_markdown\").check_all_main_files();\n}\n\n#[test]\nfn definition_lists() {\n BookTest::from_dir(\"markdown/definition_lists\")\n .check_all_main_files()\n .run(\"build\", |cmd| {\n cmd.env(\"MDBOOK_OUTPUT__HTML__DEFINITION_LISTS\", \"false\");\n })\n .check_main_file(\n \"book/definition_lists.html\",\n file![\"markdown/definition_lists/expected_disabled/definition_lists.html\"],\n )\n .check_main_file(\n \"book/html_definition_lists.html\",\n file![\"markdown/definition_lists/expected_disabled/html_definition_lists.html\"],\n );\n}\n\n#[test]\nfn admonitions() {\n BookTest::from_dir(\"markdown/admonitions\")\n .check_all_main_files()\n .run(\"build\", |cmd| {\n cmd.env(\"MDBOOK_OUTPUT__HTML__ADMONITIONS\", \"false\");\n })\n .check_main_file(\n \"book/admonitions.html\",\n file![\"markdown/admonitions/expected_disabled/admonitions.html\"],\n );\n}\n" }, { "path": "tests/testsuite/playground/disabled_playground/book.toml", "content": "[book]\ntitle = \"playground_on_rust_code\"\n\n[output.html.playground]\nrunnable = false\n" }, { "path": "tests/testsuite/playground/disabled_playground/src/SUMMARY.md", "content": "# Summary\n\n- [Rust Playground](./disabled-rust-playground.md)\n" }, { "path": "tests/testsuite/playground/disabled_playground/src/disabled-rust-playground.md", "content": "# Rust Sample\n\n```rust\nlet x = 1;\n```\n" }, { "path": "tests/testsuite/playground/playground_on_rust_code/book.toml", "content": "[book]\ntitle = \"playground_on_rust_code\"\n" }, { "path": "tests/testsuite/playground/playground_on_rust_code/src/SUMMARY.md", "content": "# Summary\n\n- [Rust Playground](./rust-playground.md)\n" }, { "path": "tests/testsuite/playground/playground_on_rust_code/src/rust-playground.md", "content": "# Rust Sample\n\n```rust\nlet x = 1;\n```\n" }, { "path": "tests/testsuite/playground.rs", "content": "//! Tests for Rust playground support.\n\nuse crate::prelude::*;\n\n// Verifies that a rust codeblock gets the playground class.\n#[test]\nfn playground_on_rust_code() {\n BookTest::from_dir(\"playground/playground_on_rust_code\").check_main_file(\n \"book/index.html\",\n str![[r##\"\n

Rust Sample

\n
#![allow(unused)]\nfn main() {\nlet x = 1;\n}
\n\"##]],\n );\n}\n\n// When the playground is disabled, there should be no playground class.\n#[test]\nfn disabled_playground() {\n BookTest::from_dir(\"playground/disabled_playground\").check_main_file(\n \"book/index.html\",\n str![[r##\"\n

Rust Sample

\n
let x = 1;
\n\"##]],\n );\n}\n" }, { "path": "tests/testsuite/preprocessor/extension_compatibility/book.toml", "content": "[book]\ntitle = \"extension_compatibility\"\n\n[preprocessor.my-preprocessor]\ncommand = \"./my-preprocessor\"\ncustom-config = true\noptional = true\n[preprocessor.my-preprocessor.custom-table]\nextra = \"abc\"\n\n[output.html]\n\n[output.my-renderer]\ncommand = \"./my-renderer\"\ncustom-config = \"renderer settings\"\noptional = true\n[output.my-renderer.custom-table]\nextra = \"xyz\"\n" }, { "path": "tests/testsuite/preprocessor/extension_compatibility/src/SUMMARY.md", "content": "# Summary\n\n[Prefix chapter](./prefix.md)\n\n- [Chapter 1](./chapter_1.md)\n- [Draft chapter]()\n\n# Part title\n\n- [Part chapter](./part/chapter.md)\n - [Part sub chapter](./part/sub-chapter.md)\n\n---\n\n[Suffix chapter](./suffix.md)\n" }, { "path": "tests/testsuite/preprocessor/extension_compatibility/src/chapter_1.md", "content": "# Chapter 1\n" }, { "path": "tests/testsuite/preprocessor/extension_compatibility/src/part/chapter.md", "content": "# Part chapter\n" }, { "path": "tests/testsuite/preprocessor/extension_compatibility/src/part/sub-chapter.md", "content": "# Part sub chapter\n" }, { "path": "tests/testsuite/preprocessor/extension_compatibility/src/prefix.md", "content": "# Prefix chapter\n" }, { "path": "tests/testsuite/preprocessor/extension_compatibility/src/suffix.md", "content": "# Suffix chapter\n" }, { "path": "tests/testsuite/preprocessor/failing_preprocessor/book.toml", "content": "[preprocessor.nop-preprocessor]\ncommand = \"cargo run --quiet --example nop-preprocessor --\"\nblow-up = true\n\n" }, { "path": "tests/testsuite/preprocessor/failing_preprocessor/src/SUMMARY.md", "content": "" }, { "path": "tests/testsuite/preprocessor/missing_optional_not_fatal/book.toml", "content": "[preprocessor.missing]\ncommand = \"trduyvbhijnorgevfuhn\"\noptional = true\n" }, { "path": "tests/testsuite/preprocessor/missing_optional_not_fatal/src/SUMMARY.md", "content": "" }, { "path": "tests/testsuite/preprocessor/missing_preprocessor/book.toml", "content": "[preprocessor.missing]\ncommand = \"trduyvbhijnorgevfuhn\"\n\n" }, { "path": "tests/testsuite/preprocessor/missing_preprocessor/src/SUMMARY.md", "content": "" }, { "path": "tests/testsuite/preprocessor/nop_preprocessor/book.toml", "content": "[preprocessor.nop-preprocessor]\ncommand = \"cargo run --quiet --example nop-preprocessor --\"\n" }, { "path": "tests/testsuite/preprocessor/nop_preprocessor/src/SUMMARY.md", "content": "" }, { "path": "tests/testsuite/preprocessor.rs", "content": "//! Tests for custom preprocessors.\n\nuse crate::book_test::list_all_files;\nuse crate::prelude::*;\nuse anyhow::Result;\nuse mdbook_core::book::{Book, BookItem, Chapter};\nuse mdbook_driver::builtin_preprocessors::CmdPreprocessor;\nuse mdbook_preprocessor::{Preprocessor, PreprocessorContext};\nuse snapbox::IntoData;\nuse std::sync::{Arc, Mutex};\n\nstruct Spy(Arc>);\n\n#[derive(Debug, Default)]\nstruct Inner {\n run_count: usize,\n rendered_with: Vec,\n}\n\nimpl Preprocessor for Spy {\n fn name(&self) -> &str {\n \"dummy\"\n }\n\n fn run(&self, ctx: &PreprocessorContext, book: Book) -> Result {\n let mut inner = self.0.lock().unwrap();\n inner.run_count += 1;\n inner.rendered_with.push(ctx.renderer.clone());\n Ok(book)\n }\n}\n\n// Test that preprocessor gets run.\n#[test]\nfn runs_preprocessors() {\n let test = BookTest::init(|_| {});\n let spy: Arc> = Default::default();\n let mut book = test.load_book();\n book.with_preprocessor(Spy(Arc::clone(&spy)));\n book.build().unwrap();\n\n let inner = spy.lock().unwrap();\n assert_eq!(inner.run_count, 1);\n assert_eq!(inner.rendered_with, [\"html\"]);\n}\n\n// Run tests with a custom preprocessor.\n#[test]\nfn test_with_custom_preprocessor() {\n let test = BookTest::init(|_| {});\n let spy: Arc> = Default::default();\n let mut book = test.load_book();\n book.with_preprocessor(Spy(Arc::clone(&spy)));\n book.test(vec![]).unwrap();\n\n let inner = spy.lock().unwrap();\n assert_eq!(inner.run_count, 1);\n assert_eq!(inner.rendered_with, [\"test\"]);\n}\n\n// No-op preprocessor works.\n#[test]\nfn nop_preprocessor() {\n BookTest::from_dir(\"preprocessor/nop_preprocessor\").run(\"build\", |cmd| {\n cmd.expect_stdout(str![[\"\"]]).expect_stderr(str![[r#\"\n INFO Book building has started\n INFO Running the html backend\n INFO HTML book written to `[ROOT]/book`\n\n\"#]]);\n });\n}\n\n// Failing preprocessor generates an error.\n#[test]\nfn failing_preprocessor() {\n BookTest::from_dir(\"preprocessor/failing_preprocessor\").run(\"build\", |cmd| {\n cmd.expect_failure()\n .expect_stdout(str![[\"\"]])\n .expect_stderr(str![[r#\"\n INFO Book building has started\nBoom!!1!\nERROR The \"nop-preprocessor\" preprocessor exited unsuccessfully with [EXIT_STATUS]: 1 status\n\n\"#]]);\n });\n}\n\nfn example() -> CmdPreprocessor {\n CmdPreprocessor::new(\n \"nop-preprocessor\".to_string(),\n \"cargo run --quiet --example nop-preprocessor --\".to_string(),\n std::env::current_dir().unwrap(),\n false,\n )\n}\n\n#[test]\nfn example_supports_whatever() {\n let cmd = example();\n\n let got = cmd.supports_renderer(\"whatever\").unwrap();\n\n assert_eq!(got, true);\n}\n\n#[test]\nfn example_doesnt_support_not_supported() {\n let cmd = example();\n\n let got = cmd.supports_renderer(\"not-supported\").unwrap();\n\n assert_eq!(got, false);\n}\n\n// Checks the behavior of a relative path to a preprocessor.\n#[test]\nfn relative_command_path() {\n let mut test = BookTest::init(|_| {});\n test.rust_program(\n \"preprocessors/my-preprocessor\",\n r#\"\n fn main() {\n let mut args = std::env::args().skip(1);\n if args.next().as_deref() == Some(\"supports\") {\n std::fs::write(\"support-check\", args.next().unwrap()).unwrap();\n return;\n }\n use std::io::Read;\n let mut s = String::new();\n std::io::stdin().read_to_string(&mut s).unwrap();\n std::fs::write(\"preprocessor-ran\", \"test\").unwrap();\n println!(\"{{\\\"items\\\": []}}\");\n }\n \"#,\n )\n .change_file(\n \"book.toml\",\n \"[preprocessor.my-preprocessor]\\n\\\n command = 'preprocessors/my-preprocessor'\\n\",\n )\n .run(\"build\", |cmd| {\n cmd.expect_stdout(str![\"\"]).expect_stderr(str![[r#\"\n INFO Book building has started\n INFO Running the html backend\n INFO HTML book written to `[ROOT]/book`\n\n\"#]]);\n })\n .check_file(\"support-check\", \"html\")\n .check_file(\"preprocessor-ran\", \"test\")\n // Try again, but outside of the book root to check relative path behavior.\n .rm_r(\"support-check\")\n .rm_r(\"preprocessor-ran\")\n .run(\"build ..\", |cmd| {\n cmd.current_dir(cmd.dir.join(\"src\"))\n .expect_stdout(str![\"\"])\n .expect_stderr(str![[r#\"\n INFO Book building has started\n INFO Running the html backend\n INFO HTML book written to `[ROOT]/src/../book`\n\n\"#]]);\n })\n .check_file(\"support-check\", \"html\")\n .check_file(\"preprocessor-ran\", \"test\");\n}\n\n// Preprocessor command is missing.\n#[test]\nfn missing_preprocessor() {\n BookTest::from_dir(\"preprocessor/missing_preprocessor\").run(\"build\", |cmd| {\n cmd.expect_failure()\n .expect_stdout(str![[\"\"]])\n .expect_stderr(str![[r#\"\n INFO Book building has started\nERROR The command `trduyvbhijnorgevfuhn` wasn't found, is the `missing` preprocessor installed? If you want to ignore this error when the `missing` preprocessor is not installed, set `optional = true` in the `[preprocessor.missing]` section of the book.toml configuration file.\nERROR Unable to run the preprocessor `missing`\n[TAB]Caused by: [NOT_FOUND]\n\n\"#]]);\n });\n}\n\n// Optional missing is not an error.\n#[test]\nfn missing_optional_not_fatal() {\n BookTest::from_dir(\"preprocessor/missing_optional_not_fatal\").run(\"build\", |cmd| {\n cmd.expect_stdout(str![[\"\"]]).expect_stderr(str![[r#\"\n INFO Book building has started\n WARN The command `trduyvbhijnorgevfuhn` for preprocessor `missing` was not found, but is marked as optional.\n INFO Running the html backend\n INFO HTML book written to `[ROOT]/book`\n\n\"#]]);\n });\n}\n\n// with_preprocessor of an existing name.\n#[test]\nfn with_preprocessor_same_name() {\n let mut test = BookTest::init(|_| {});\n test.change_file(\n \"book.toml\",\n \"[preprocessor.dummy]\\n\\\n command = 'mdbook-preprocessor-does-not-exist'\\n\",\n );\n let spy: Arc> = Default::default();\n let mut book = test.load_book();\n book.with_preprocessor(Spy(Arc::clone(&spy)));\n // Unfortunately this is unable to capture the output when using the API.\n book.build().unwrap();\n let inner = spy.lock().unwrap();\n assert_eq!(inner.run_count, 1);\n assert_eq!(inner.rendered_with, [\"html\"]);\n}\n\n// Checks that the interface stays backwards compatible. The interface here\n// should not be changed to fix a compatibility issue unless there is a\n// major-semver version update to mdbook.\n//\n// Note that this tests both preprocessors and renderers. It's in this module\n// for lack of a better location.\n#[test]\nfn extension_compatibility() {\n // This is here to force you to look at this test if you alter any of\n // these types such as adding new fields/variants. This test should be\n // updated accordingly. For example, new `BookItem` variants should be\n // added to the extension_compatibility book, or new fields should be\n // added to the expected input/output. This is also a check that these\n // should only be changed in a semver-breaking release\n let chapter = Chapter {\n name: \"example\".to_string(),\n content: \"content\".to_string(),\n number: None,\n sub_items: Vec::new(),\n path: None,\n source_path: None,\n parent_names: Vec::new(),\n };\n let item = BookItem::Chapter(chapter);\n match &item {\n BookItem::Chapter(_) => {}\n BookItem::Separator => {}\n BookItem::PartTitle(_) => {}\n }\n let items = vec![item];\n let _book = Book { items };\n\n let mut test = BookTest::from_dir(\"preprocessor/extension_compatibility\");\n // Run it once with the preprocessor disabled so that we can verify\n // that the built book is identical with the preprocessor enabled.\n test.run(\"build\", |cmd| {\n cmd.expect_stdout(str![[\"\"]]).expect_stderr(str![[r#\"\n INFO Book building has started\n WARN The command `./my-preprocessor` for preprocessor `my-preprocessor` was not found, but is marked as optional.\n INFO Running the html backend\n INFO HTML book written to `[ROOT]/book/html`\n WARN The command `./my-preprocessor` for preprocessor `my-preprocessor` was not found, but is marked as optional.\n INFO Running the my-renderer backend\n INFO Invoking the \"my-renderer\" renderer\n WARN The command `./my-renderer` for backend `my-renderer` was not found, but is marked as optional.\n\n\"#]]);\n });\n let orig_dir = test.dir.join(\"book.orig\");\n let pre_dir = test.dir.join(\"book\");\n std::fs::rename(&pre_dir, &orig_dir).unwrap();\n\n // **CAUTION** DO NOT modify this value unless this is a major-semver change.\n let book_output = serde_json::json!({\n \"items\": [\n {\n \"Chapter\": {\n \"content\": \"# Prefix chapter\\n\",\n \"name\": \"Prefix chapter\",\n \"number\": null,\n \"parent_names\": [],\n \"path\": \"prefix.md\",\n \"source_path\": \"prefix.md\",\n \"sub_items\": []\n }\n },\n {\n \"Chapter\": {\n \"content\": \"# Chapter 1\\n\",\n \"name\": \"Chapter 1\",\n \"number\": [\n 1\n ],\n \"parent_names\": [],\n \"path\": \"chapter_1.md\",\n \"source_path\": \"chapter_1.md\",\n \"sub_items\": []\n }\n },\n {\n \"Chapter\": {\n \"content\": \"\",\n \"name\": \"Draft chapter\",\n \"number\": [\n 2\n ],\n \"parent_names\": [],\n \"path\": null,\n \"source_path\": null,\n \"sub_items\": []\n }\n },\n {\n \"PartTitle\": \"Part title\"\n },\n {\n \"Chapter\": {\n \"content\": \"# Part chapter\\n\",\n \"name\": \"Part chapter\",\n \"number\": [\n 3\n ],\n \"parent_names\": [],\n \"path\": \"part/chapter.md\",\n \"source_path\": \"part/chapter.md\",\n \"sub_items\": [\n {\n \"Chapter\": {\n \"content\": \"# Part sub chapter\\n\",\n \"name\": \"Part sub chapter\",\n \"number\": [\n 3,\n 1\n ],\n \"parent_names\": [\n \"Part chapter\"\n ],\n \"path\": \"part/sub-chapter.md\",\n \"source_path\": \"part/sub-chapter.md\",\n \"sub_items\": []\n }\n }\n ]\n }\n },\n \"Separator\",\n {\n \"Chapter\": {\n \"content\": \"# Suffix chapter\\n\",\n \"name\": \"Suffix chapter\",\n \"number\": null,\n \"parent_names\": [],\n \"path\": \"suffix.md\",\n \"source_path\": \"suffix.md\",\n \"sub_items\": []\n }\n }\n ]\n });\n let output_str = serde_json::to_string(&book_output).unwrap();\n // **CAUTION** The only updates allowed here in a semver-compatible\n // release is to add new fields.\n let expected_config = serde_json::json!({\n \"book\": {\n \"authors\": [],\n \"description\": null,\n \"language\": \"en\",\n \"text-direction\": null,\n \"title\": \"extension_compatibility\"\n },\n \"output\": {\n \"html\": {},\n \"my-renderer\": {\n \"command\": \"./my-renderer\",\n \"custom-config\": \"renderer settings\",\n \"custom-table\": {\n \"extra\": \"xyz\"\n },\n \"optional\": true\n }\n },\n \"preprocessor\": {\n \"my-preprocessor\": {\n \"command\": \"./my-preprocessor\",\n \"custom-config\": true,\n \"custom-table\": {\n \"extra\": \"abc\"\n },\n \"optional\": true\n }\n }\n });\n\n // **CAUTION** The only updates allowed here in a semver-compatible\n // release is to add new fields. The output should not change.\n let expected_preprocessor_input = serde_json::json!([\n {\n \"config\": expected_config,\n \"mdbook_version\": \"[VERSION]\",\n \"renderer\": \"html\",\n \"root\": \"[ROOT]\"\n },\n book_output\n ]);\n let expected_renderer_input = serde_json::json!(\n {\n \"version\": \"[VERSION]\",\n \"root\": \"[ROOT]\",\n \"book\": book_output,\n \"config\": expected_config,\n \"destination\": \"[ROOT]/book/my-renderer\",\n }\n );\n\n // This preprocessor writes its input to some files, and writes the\n // hard-coded output specified above.\n test.rust_program(\n \"my-preprocessor\",\n &r###\"\n use std::fs::OpenOptions;\n use std::io::{Read, Write};\n fn main() {\n let mut args = std::env::args().skip(1);\n if args.next().as_deref() == Some(\"supports\") {\n let mut file = OpenOptions::new()\n .create(true)\n .append(true)\n .open(\"support-check\")\n .unwrap();\n let renderer = args.next().unwrap();\n writeln!(file, \"{renderer}\").unwrap();\n if renderer != \"html\" {\n std::process::exit(1);\n }\n return;\n }\n let mut s = String::new();\n std::io::stdin().read_to_string(&mut s).unwrap();\n std::fs::write(\"preprocessor-input\", &s).unwrap();\n let output = r##\"OUTPUT_REPLACE\"##;\n println!(\"{output}\");\n }\n \"###\n .replace(\"OUTPUT_REPLACE\", &output_str),\n )\n // This renderer writes its input to a file.\n .rust_program(\n \"my-renderer\",\n &r#\"\n fn main() {\n use std::io::Read;\n let mut s = String::new();\n std::io::stdin().read_to_string(&mut s).unwrap();\n std::fs::write(\"renderer-input\", &s).unwrap();\n }\n \"#,\n )\n .run(\"build\", |cmd| {\n cmd.expect_stdout(str![[\"\"]]).expect_stderr(str![[r#\"\n INFO Book building has started\n INFO Running the html backend\n INFO HTML book written to `[ROOT]/book/html`\n INFO Running the my-renderer backend\n INFO Invoking the \"my-renderer\" renderer\n\n\"#]]);\n })\n .check_file(\"support-check\", \"html\\nmy-renderer\\n\")\n .check_file(\n \"preprocessor-input\",\n serde_json::to_string(&expected_preprocessor_input)\n .unwrap()\n .is_json(),\n )\n .check_file(\n \"book/my-renderer/renderer-input\",\n serde_json::to_string(&expected_renderer_input)\n .unwrap()\n .is_json(),\n );\n // Verify both directories have the exact same output.\n test.rm_r(\"book/my-renderer/renderer-input\");\n let orig_files = list_all_files(&orig_dir);\n let pre_files = list_all_files(&pre_dir);\n assert_eq!(orig_files, pre_files);\n for file in &orig_files {\n let orig_path = orig_dir.join(file);\n if orig_path.is_file() {\n let orig = std::fs::read(&orig_path).unwrap();\n let pre = std::fs::read(&pre_dir.join(file)).unwrap();\n test.assert.eq(pre, orig);\n }\n }\n}\n" }, { "path": "tests/testsuite/print/chapter_no_h1/book.toml", "content": "[book]\ntitle = \"chapter_no_h1\"\n" }, { "path": "tests/testsuite/print/chapter_no_h1/expected/print.html", "content": "

Chapter 1

\n

See chapter 2.

\n
\n

Chapter 2

\n

See this.

\n
\n

H2 instead

\n

H2 instead

\n

This has H2 instead of H1.

" }, { "path": "tests/testsuite/print/chapter_no_h1/src/SUMMARY.md", "content": "# Summary\n\n- [Chapter 1](./chapter_1.md)\n- [Chapter 2](./chapter_2.md)\n- [H2 instead](./h2-instead.md)\n" }, { "path": "tests/testsuite/print/chapter_no_h1/src/chapter_1.md", "content": "# Chapter 1\n\nSee [chapter 2](chapter_2.md).\n" }, { "path": "tests/testsuite/print/chapter_no_h1/src/chapter_2.md", "content": "See [this](./chapter_2.md).\n" }, { "path": "tests/testsuite/print/chapter_no_h1/src/h2-instead.md", "content": "## H2 instead\n\nThis has H2 instead of H1.\n\n" }, { "path": "tests/testsuite/print/duplicate_ids/book.toml", "content": "[book]\ntitle = \"duplicate_ids\"\n" }, { "path": "tests/testsuite/print/duplicate_ids/expected/print.html", "content": "

Chapter 1

\n

Some title

\n

See other

\n

See this

\n

See this anchor only

\n
\n

Chapter 2

\n

Some title

\n

See other

\n

See this

\n

See this anchor only

\n

Works with HTML extension too

" }, { "path": "tests/testsuite/print/duplicate_ids/src/SUMMARY.md", "content": "# Summary\n\n- [Chapter 1](./chapter_1.md)\n- [Chapter 2](./chapter_2.md)\n" }, { "path": "tests/testsuite/print/duplicate_ids/src/chapter_1.md", "content": "# Chapter 1\n\n## Some title\n\nSee [other](chapter_2.md#some-title)\n\nSee [this](chapter_1.md#some-title)\n\nSee [this anchor only](#some-title)\n" }, { "path": "tests/testsuite/print/duplicate_ids/src/chapter_2.md", "content": "# Chapter 2\n\n## Some title\n\nSee [other](chapter_1.md#some-title)\n\nSee [this](chapter_2.md#some-title)\n\nSee [this anchor only](#some-title)\n\n[Works with HTML extension too](chapter_1.html#some-title)\n" }, { "path": "tests/testsuite/print/noindex/src/SUMMARY.md", "content": "- [Intro](index.md)\n" }, { "path": "tests/testsuite/print/noindex/src/index.md", "content": "# Intro\n" }, { "path": "tests/testsuite/print/relative_links/book.toml", "content": "[book]\ntitle = \"relative_links\"\n" }, { "path": "tests/testsuite/print/relative_links/expected/print.html", "content": "

First Chapter

\n
\n

First Nested

\n
\n

Testing relative links for the print page

\n

When we link to the first section, it should work on\nboth the print page and the non-print page.

\n

The same link should work with an html extension.

\n

A fragment link should work.

\n

Link outside.

\n

Link outside with anchor.

\n

Link inside but doesn’t exist.\nLink inside but doesn’t exist with anchor.\nLink inside to html.\nLink inside to html with anchor.

\n

\"Some

\n

HTML Link

\n\"raw\n

Some section

\n

Links with scheme shouldn’t be touched.

\n

Non-html link

" }, { "path": "tests/testsuite/print/relative_links/src/SUMMARY.md", "content": "# Summary\n\n- [First Chapter](first/index.md)\n - [First Nested](first/nested.md)\n- [Second Chapter](second/nested.md)\n" }, { "path": "tests/testsuite/print/relative_links/src/first/index.md", "content": "# First Chapter\n" }, { "path": "tests/testsuite/print/relative_links/src/first/nested.md", "content": "# First Nested\n" }, { "path": "tests/testsuite/print/relative_links/src/second/nested.md", "content": "# Testing relative links for the print page\n\nWhen we link to [the first section](../first/nested.md), it should work on\nboth the print page and the non-print page.\n\nThe same link should work [with an html extension](../first/nested.html).\n\nA [fragment link](#some-section) should work.\n\nLink [outside](../../std/foo/bar.html).\n\nLink [outside with anchor](../../std/foo/bar.html#panic).\n\nLink [inside but doesn't exist](../first/alpha/beta.md).\nLink [inside but doesn't exist with anchor](../first/alpha/beta.md#anchor).\nLink [inside to html](../first/alpha/gamma.html).\nLink [inside to html with anchor](../first/alpha/gamma.html#anchor).\n\n![Some image](../images/picture.png)\n\nHTML Link\n\n\"raw\n\n## Some section\n\n[Links with scheme shouldn't be touched.](https://example.com/foo.html#bar)\n\nNon-html link\n" }, { "path": "tests/testsuite/print.rs", "content": "//! Tests for print page.\n\nuse crate::prelude::*;\nuse snapbox::file;\n\n// Tests relative links from the print page.\n#[test]\nfn relative_links() {\n BookTest::from_dir(\"print/relative_links\").check_main_file(\n \"book/print.html\",\n file!(\"print/relative_links/expected/print.html\"),\n );\n}\n\n// Test for duplicate IDs, and links to those duplicates.\n#[test]\nfn duplicate_ids() {\n BookTest::from_dir(\"print/duplicate_ids\").check_main_file(\n \"book/print.html\",\n file!(\"print/duplicate_ids/expected/print.html\"),\n );\n}\n\n// Test for synthesized link to a chapter that does not have an h1.\n#[test]\nfn chapter_no_h1() {\n BookTest::from_dir(\"print/chapter_no_h1\").check_main_file(\n \"book/print.html\",\n file!(\"print/chapter_no_h1/expected/print.html\"),\n );\n}\n\n// Checks that print.html is noindex.\n#[test]\nfn noindex() {\n let robots = r#\"\"#;\n BookTest::from_dir(\"print/noindex\")\n .check_file_contains(\"book/print.html\", robots)\n .check_file_doesnt_contain(\"book/index.html\", robots);\n}\n" }, { "path": "tests/testsuite/redirects/redirect_existing_page/book.toml", "content": "[book]\ntitle = \"redirect_existing_page\"\n\n[output.html.redirect]\n\"/chapter_1.html\" = \"other-page.html\"\n" }, { "path": "tests/testsuite/redirects/redirect_existing_page/src/SUMMARY.md", "content": "# Summary\n\n- [Chapter 1](./chapter_1.md)\n" }, { "path": "tests/testsuite/redirects/redirect_existing_page/src/chapter_1.md", "content": "# Chapter 1\n" }, { "path": "tests/testsuite/redirects/redirect_removed_with_fragments_only/book.toml", "content": "[book]\ntitle = \"redirect_removed_with_fragments_only\"\n\n[output.html.redirect]\n\"/old-file.html#foo\" = \"chapter_1.html\"\n" }, { "path": "tests/testsuite/redirects/redirect_removed_with_fragments_only/src/SUMMARY.md", "content": "# Summary\n\n- [Chapter 1](./chapter_1.md)\n" }, { "path": "tests/testsuite/redirects/redirect_removed_with_fragments_only/src/chapter_1.md", "content": "# Chapter 1\n" }, { "path": "tests/testsuite/redirects/redirects_are_emitted_correctly/book.toml", "content": "[book]\ntitle = \"redirects_are_emitted_correctly\"\n\n[output.html.redirect]\n\"/overview.html\" = \"index.html\"\n\"/overview.html#old\" = \"index.html#new\"\n\"/nested/page.html\" = \"https://rust-lang.org/\"\n" }, { "path": "tests/testsuite/redirects/redirects_are_emitted_correctly/expected/nested/page.html", "content": "\n\n \n \n Redirecting...\n \n \n \n \n

Redirecting to... https://rust-lang.org/.

\n\n\n \n\n" }, { "path": "tests/testsuite/redirects/redirects_are_emitted_correctly/expected/overview.html", "content": "\n\n \n \n Redirecting...\n \n \n \n \n

Redirecting to... index.html.

\n\n\n \n\n" }, { "path": "tests/testsuite/redirects/redirects_are_emitted_correctly/src/SUMMARY.md", "content": "# Redirects\n\n- [Chapter 1](chapter_1.md)\n- [Chapter 2](chapter_2.md)\n" }, { "path": "tests/testsuite/redirects/redirects_are_emitted_correctly/src/chapter_1.md", "content": "# Chapter 1\n" }, { "path": "tests/testsuite/redirects/redirects_are_emitted_correctly/src/chapter_2.md", "content": "# Chapter 2\n" }, { "path": "tests/testsuite/redirects.rs", "content": "//! Tests for the HTML redirect feature.\n\nuse crate::prelude::*;\nuse snapbox::file;\n\n// Basic check of redirects.\n#[test]\nfn redirects_are_emitted_correctly() {\n BookTest::from_dir(\"redirects/redirects_are_emitted_correctly\")\n .check_file(\n \"book/overview.html\",\n file![\"redirects/redirects_are_emitted_correctly/expected/overview.html\"],\n )\n .check_file(\n \"book/nested/page.html\",\n file![\"redirects/redirects_are_emitted_correctly/expected/nested/page.html\"],\n );\n}\n\n// Invalid redirect with only fragments.\n#[test]\nfn redirect_removed_with_fragments_only() {\n BookTest::from_dir(\"redirects/redirect_removed_with_fragments_only\").run(\"build\", |cmd| {\n cmd.expect_failure().expect_stderr(str![[r#\"\n INFO Book building has started\n INFO Running the html backend\nERROR Rendering failed\n[TAB]Caused by: Unable to emit redirects\n[TAB]Caused by: redirect entry for `old-file.html` only has source paths with `#` fragments\nThere must be an entry without the `#` fragment to determine the default destination.\n\n\"#]]);\n });\n}\n\n// Invalid redirect for an existing page.\n#[test]\nfn redirect_existing_page() {\n BookTest::from_dir(\"redirects/redirect_existing_page\").run(\"build\", |cmd| {\n cmd.expect_failure().expect_stderr(str![[r#\"\n INFO Book building has started\n INFO Running the html backend\nERROR Rendering failed\n[TAB]Caused by: redirect found for existing chapter at `/chapter_1.html`\nEither delete the redirect or remove the chapter.\n\n\"#]]);\n });\n}\n" }, { "path": "tests/testsuite/renderer/backends_receive_render_context_via_stdin/book.toml", "content": "[output.cat-to-file]\ncommand = \"./cat-to-file\"\n\n" }, { "path": "tests/testsuite/renderer/backends_receive_render_context_via_stdin/src/SUMMARY.md", "content": "- [Chapter 1](./chapter_1.md)\n" }, { "path": "tests/testsuite/renderer/backends_receive_render_context_via_stdin/src/chapter_1.md", "content": "# Chapter 1\n" }, { "path": "tests/testsuite/renderer/missing_optional_not_fatal/book.toml", "content": "[output.missing]\ncommand = \"trduyvbhijnorgevfuhn\"\noptional = true\n\n" }, { "path": "tests/testsuite/renderer/missing_optional_not_fatal/src/SUMMARY.md", "content": "" }, { "path": "tests/testsuite/renderer/missing_renderer/book.toml", "content": "[output.missing]\ncommand = \"trduyvbhijnorgevfuhn\"\n\n" }, { "path": "tests/testsuite/renderer/missing_renderer/src/SUMMARY.md", "content": "" }, { "path": "tests/testsuite/renderer/renderer_with_arguments/book.toml", "content": "[output.arguments]\ncommand = \"./arguments arg1 arg2\"\n\n" }, { "path": "tests/testsuite/renderer/renderer_with_arguments/src/SUMMARY.md", "content": "" }, { "path": "tests/testsuite/renderer.rs", "content": "//! Tests for custom renderers.\n\nuse crate::prelude::*;\nuse anyhow::Result;\nuse mdbook_renderer::{RenderContext, Renderer};\nuse snapbox::IntoData;\nuse std::fs::File;\nuse std::sync::{Arc, Mutex};\n\nstruct Spy(Arc>);\n\n#[derive(Debug, Default)]\nstruct Inner {\n run_count: usize,\n}\n\nimpl Renderer for Spy {\n fn name(&self) -> &str {\n \"dummy\"\n }\n\n fn render(&self, _ctx: &RenderContext) -> Result<()> {\n let mut inner = self.0.lock().unwrap();\n inner.run_count += 1;\n Ok(())\n }\n}\n\n// Test that renderer gets run.\n#[test]\nfn runs_renderers() {\n let test = BookTest::init(|_| {});\n let spy: Arc> = Default::default();\n let mut book = test.load_book();\n book.with_renderer(Spy(Arc::clone(&spy)));\n book.build().unwrap();\n\n let inner = spy.lock().unwrap();\n assert_eq!(inner.run_count, 1);\n}\n\n// Test renderer with a failing command fails.\n#[test]\nfn failing_command() {\n BookTest::init(|_| {})\n .rust_program(\n \"failing\",\n r#\"\n fn main() {\n // Read from stdin to avoid random pipe failures on Linux.\n use std::io::Read;\n let mut s = String::new();\n std::io::stdin().read_to_string(&mut s).unwrap();\n std::process::exit(1);\n }\n \"#,\n )\n .change_file(\n \"book.toml\",\n \"[output.failing]\\n\\\n command = './failing'\\n\",\n )\n .run(\"build\", |cmd| {\n cmd.expect_failure()\n .expect_stdout(str![[\"\"]])\n .expect_stderr(str![[r#\"\n INFO Book building has started\n INFO Running the failing backend\n INFO Invoking the \"failing\" renderer\nERROR Renderer exited with non-zero return code.\nERROR Rendering failed\n[TAB]Caused by: The \"failing\" renderer failed\n\n\"#]]);\n });\n}\n\n// Renderer command is missing.\n#[test]\nfn missing_renderer() {\n BookTest::from_dir(\"renderer/missing_renderer\").run(\"build\", |cmd| {\n cmd.expect_failure()\n .expect_stdout(str![[\"\"]])\n .expect_stderr(str![[r#\"\n INFO Book building has started\n INFO Running the missing backend\n INFO Invoking the \"missing\" renderer\nERROR The command `trduyvbhijnorgevfuhn` wasn't found, is the `missing` backend installed? If you want to ignore this error when the `missing` backend is not installed, set `optional = true` in the `[output.missing]` section of the book.toml configuration file.\nERROR Rendering failed\n[TAB]Caused by: Unable to run the backend `missing`\n[TAB]Caused by: [NOT_FOUND]\n\n\"#]]);\n });\n}\n\n// Optional missing is not an error.\n#[test]\nfn missing_optional_not_fatal() {\n BookTest::from_dir(\"renderer/missing_optional_not_fatal\").run(\"build\", |cmd| {\n cmd.expect_stdout(str![[\"\"]]).expect_stderr(str![[r#\"\n INFO Book building has started\n INFO Running the missing backend\n INFO Invoking the \"missing\" renderer\n WARN The command `trduyvbhijnorgevfuhn` for backend `missing` was not found, but is marked as optional.\n\n\"#]]);\n });\n}\n\n// Command can include arguments.\n#[test]\nfn renderer_with_arguments() {\n BookTest::from_dir(\"renderer/renderer_with_arguments\")\n .rust_program(\n \"arguments\",\n r#\"\n fn main() {\n let args: Vec<_> = std::env::args().skip(1).collect();\n assert_eq!(args, &[\"arg1\", \"arg2\"]);\n println!(\"Hello World!\");\n use std::io::Read;\n let mut s = String::new();\n std::io::stdin().read_to_string(&mut s).unwrap();\n }\n \"#,\n )\n .run(\"build\", |cmd| {\n cmd.expect_stdout(str![[r#\"\nHello World!\n\n\"#]])\n .expect_stderr(str![[r#\"\n INFO Book building has started\n INFO Running the arguments backend\n INFO Invoking the \"arguments\" renderer\n\n\"#]]);\n });\n}\n\n// Checks the render context received by the renderer.\n#[test]\nfn backends_receive_render_context_via_stdin() {\n let mut test = BookTest::from_dir(\"renderer/backends_receive_render_context_via_stdin\");\n test.rust_program(\n \"cat-to-file\",\n r#\"\n fn main() {\n use std::io::Read;\n let mut s = String::new();\n std::io::stdin().read_to_string(&mut s).unwrap();\n std::fs::write(\"out.txt\", s).unwrap();\n }\n \"#,\n )\n .run(\"build\", |cmd| {\n cmd.expect_stdout(str![[\"\"]]).expect_stderr(str![[r#\"\n INFO Book building has started\n INFO Running the cat-to-file backend\n INFO Invoking the \"cat-to-file\" renderer\n\n\"#]]);\n })\n .check_file(\n \"book/out.txt\",\n str![[r##\"\n{\n \"book\": {\n \"items\": [\n {\n \"Chapter\": {\n \"content\": \"# Chapter 1\\n\",\n \"name\": \"Chapter 1\",\n \"number\": [\n 1\n ],\n \"parent_names\": [],\n \"path\": \"chapter_1.md\",\n \"source_path\": \"chapter_1.md\",\n \"sub_items\": []\n }\n }\n ]\n },\n \"config\": {\n \"book\": {\n \"authors\": [],\n \"description\": null,\n \"language\": \"en\",\n \"text-direction\": null,\n \"title\": null\n },\n \"output\": {\n \"cat-to-file\": {\n \"command\": \"./cat-to-file\"\n }\n }\n },\n \"destination\": \"[ROOT]/book\",\n \"root\": \"[ROOT]\",\n \"version\": \"[VERSION]\"\n}\n\"##]]\n .is_json(),\n );\n\n // Can round-trip.\n let f = File::open(test.dir.join(\"book/out.txt\")).unwrap();\n RenderContext::from_json(f).unwrap();\n}\n\n// Verifies that a relative path for the renderer command is relative to the\n// book root.\n#[test]\nfn relative_command_path() {\n let mut test = BookTest::init(|_| {});\n test.rust_program(\n \"renderers/myrenderer\",\n r#\"\n fn main() {\n use std::io::Read;\n let mut s = String::new();\n std::io::stdin().read_to_string(&mut s).unwrap();\n std::fs::write(\"output\", \"test\").unwrap();\n }\n \"#,\n )\n .change_file(\n \"book.toml\",\n \"[output.myrenderer]\\n\\\n command = 'renderers/myrenderer'\\n\",\n )\n .run(\"build\", |cmd| {\n cmd.expect_stdout(str![[\"\"]]).expect_stderr(str![[r#\"\n INFO Book building has started\n INFO Running the myrenderer backend\n INFO Invoking the \"myrenderer\" renderer\n\n\"#]]);\n })\n .check_file(\"book/output\", \"test\");\n}\n\n// with_renderer of an existing name.\n#[test]\nfn with_renderer_same_name() {\n let mut test = BookTest::init(|_| {});\n test.change_file(\n \"book.toml\",\n \"[output.dummy]\\n\\\n command = 'mdbook-renderer-does-not-exist'\\n\",\n );\n let spy: Arc> = Default::default();\n let mut book = test.load_book();\n book.with_renderer(Spy(Arc::clone(&spy)));\n // Unfortunately this is unable to capture the output when using the API.\n book.build().unwrap();\n let inner = spy.lock().unwrap();\n assert_eq!(inner.run_count, 1);\n}\n" }, { "path": "tests/testsuite/rendering/code_blocks_fenced_with_indent/book.toml", "content": "[book]\ntitle = \"code_blocks_fenced_with_indent\"\n" }, { "path": "tests/testsuite/rendering/code_blocks_fenced_with_indent/expected/code-blocks-fenced-with-indent.html", "content": "

Code blocks fenced with indent

\n
#![allow(unused)]\nfn main() {\n    // This has a first line that is indented.\n    println!(\"hello\");\n}
" }, { "path": "tests/testsuite/rendering/code_blocks_fenced_with_indent/src/SUMMARY.md", "content": "# Summary\n\n- [Code blocks fenced with indent](./code-blocks-fenced-with-indent.md)\n" }, { "path": "tests/testsuite/rendering/code_blocks_fenced_with_indent/src/code-blocks-fenced-with-indent.md", "content": "# Code blocks fenced with indent\n\n```rust\n // This has a first line that is indented.\n println!(\"hello\");\n```\n" }, { "path": "tests/testsuite/rendering/default_rust_edition/book.toml", "content": "[book]\ntitle = \"default_rust_edition\"\n\n[rust]\nedition = \"2021\"\n" }, { "path": "tests/testsuite/rendering/default_rust_edition/expected/default-rust-edition.html", "content": "

Chapter 1

\n
#![allow(unused)]\nfn main() {\nlet x = 2021;\n}
\n
#![allow(unused)]\nfn main() {\nlet x = 2021;\n}
\n
#![allow(unused)]\nfn main() {\nlet x = 2024;\n}
" }, { "path": "tests/testsuite/rendering/default_rust_edition/src/SUMMARY.md", "content": "# Summary\n\n- [Default rust edition](./default-rust-edition.md)\n" }, { "path": "tests/testsuite/rendering/default_rust_edition/src/default-rust-edition.md", "content": "# Chapter 1\n\n```rust\nlet x = 2021;\n```\n\n```rust,edition2021\nlet x = 2021;\n```\n\n```rust,edition2024\nlet x = 2024;\n```\n" }, { "path": "tests/testsuite/rendering/edit_url_template/book.toml", "content": "[book]\ntitle = \"edit_url_template\"\n\n[output.html]\nedit-url-template = \"https://github.com/rust-lang/mdBook/edit/master/guide/{path}\"\n" }, { "path": "tests/testsuite/rendering/edit_url_template/src/SUMMARY.md", "content": "- [Intro](README.md)\n" }, { "path": "tests/testsuite/rendering/edit_url_template_explicit_src/book.toml", "content": "[book]\ntitle = \"edit_url_template\"\nsrc = \"src2\"\n\n[output.html]\nedit-url-template = \"https://github.com/rust-lang/mdBook/edit/master/guide/{path}\"\n" }, { "path": "tests/testsuite/rendering/edit_url_template_explicit_src/src2/SUMMARY.md", "content": "- [Intro](README.md)\n" }, { "path": "tests/testsuite/rendering/editable_rust_block/book.toml", "content": "[book]\ntitle = \"editable_rust_block\"\n\n[output.html.playground]\neditable = true\n" }, { "path": "tests/testsuite/rendering/editable_rust_block/expected/editable-rust.html", "content": "

Chapter 1

\n
fn f() {\n    println!(\"hello\");\n}
\n
#![allow(unused)]\nfn main() {\n// Not editable.\n}
" }, { "path": "tests/testsuite/rendering/editable_rust_block/src/SUMMARY.md", "content": "# Summary\n\n- [Editable rust blocks](./editable-rust.md)\n" }, { "path": "tests/testsuite/rendering/editable_rust_block/src/editable-rust.md", "content": "# Chapter 1\n\n```rust,editable\nfn f() {\n println!(\"hello\");\n}\n```\n\n```rust\n// Not editable.\n```\n" }, { "path": "tests/testsuite/rendering/first_chapter_is_copied_as_index_even_if_not_first_elem/src/SUMMARY.md", "content": "# Summary\n\n---\n\n- [None of these should be treated as the \"index chapter\"]()\n\n# Part 1\n\n- [Not this either]()\n- [Chapter 1](./chapter_1.md)\n- [And not this]()\n" }, { "path": "tests/testsuite/rendering/fontawesome/book.toml", "content": "[book]\ntitle = \"fontawesome\"\n" }, { "path": "tests/testsuite/rendering/fontawesome/expected/fa.html", "content": "

Chapter 1

\n

\n

\n

\n

Text prevents translation.

\n

\n

" }, { "path": "tests/testsuite/rendering/fontawesome/src/SUMMARY.md", "content": "# Summary\n\n- [Font Awesome](./fa.md)\n" }, { "path": "tests/testsuite/rendering/fontawesome/src/fa.md", "content": "# Chapter 1\n\n\n\n\n\n\n\nText prevents translation.\n\n\n\n\n" }, { "path": "tests/testsuite/rendering/fontawesome_error/book.toml", "content": "[book]\ntitle = \"fontawesome_error\"\n\n[output.html]\ngit-repository-url = \"https://github.com/example/test\"\ngit-repository-icon = \"fa-github\"\n" }, { "path": "tests/testsuite/rendering/fontawesome_error/src/SUMMARY.md", "content": "# Summary\n\n- [Chapter 1](./chapter_1.md)\n" }, { "path": "tests/testsuite/rendering/fontawesome_error/src/chapter_1.md", "content": "# Chapter 1\n\nHello, world!\n" }, { "path": "tests/testsuite/rendering/header_links/book.toml", "content": "[book]\ntitle = \"header_links\"\n" }, { "path": "tests/testsuite/rendering/header_links/expected/header_links.html", "content": "

Header Links

\n

Foo^bar

\n

\n

\n

Hï

\n

Repeat

\n

Repeat

\n

Repeat

\n

Repeat 1

\n" }, { "path": "tests/testsuite/rendering/header_links/src/SUMMARY.md", "content": "# Summary\n\n- [Header Links](./header_links.md)\n" }, { "path": "tests/testsuite/rendering/header_links/src/header_links.md", "content": "# Header Links\n\n## Foo^bar\n\n###\n\n####\n\n## Hï\n\n## Repeat\n## Repeat\n## Repeat\n\n## Repeat 1\n\n## With *emphasis* **bold** **_bold_emphasis_** `code` \\ html [link] \n\n[link]: https://example.com/link\n" }, { "path": "tests/testsuite/rendering/hidelines/book.toml", "content": "[book]\ntitle = \"hidelines\"\n\n[output.html.code.hidelines]\npython = \"~\"\n" }, { "path": "tests/testsuite/rendering/hidelines/expected/hide-lines.html", "content": "

Hide Lines

\n
hidden()\nnothidden():\n    hidden()\n    hidden()\n    nothidden()\n
\n
hidden()\nnothidden():\n    hidden()\n    hidden()\n    nothidden()\n
\n
#![allow(unused)]\n#![allow(something)]\nfn main() {\n\n#hidden();\nhidden();\n# not_hidden();\n#[not_hidden]\nnot_hidden();\n}
" }, { "path": "tests/testsuite/rendering/hidelines/src/SUMMARY.md", "content": "# Summary\n\n- [Hide Lines](./hide-lines.md)\n" }, { "path": "tests/testsuite/rendering/hidelines/src/hide-lines.md", "content": "# Hide Lines\n\n```python\n~hidden()\nnothidden():\n~ hidden()\n ~hidden()\n nothidden()\n```\n\n```python,hidelines=!!!\n!!!hidden()\nnothidden():\n!!! hidden()\n !!!hidden()\n nothidden()\n```\n\n```rust\n#![allow(something)]\n#\n#hidden();\n# hidden();\n## not_hidden();\n#[not_hidden]\nnot_hidden();\n```\n" }, { "path": "tests/testsuite/rendering/html_blocks/book.toml", "content": "[book]\ntitle = \"html_blocks\"\n" }, { "path": "tests/testsuite/rendering/html_blocks/expected/comment-in-list.html", "content": "
    \n
  • \n

    List

    \n \n
    • \n
" }, { "path": "tests/testsuite/rendering/html_blocks/expected/script-in-block.html", "content": "
\n HTML block start\n\n < still in block\n
" }, { "path": "tests/testsuite/rendering/html_blocks/src/SUMMARY.md", "content": "# Summary\n\n- [Comment in list](./comment-in-list.md)\n- [Script in block](./script-in-block.md)\n" }, { "path": "tests/testsuite/rendering/html_blocks/src/comment-in-list.md", "content": "* List\n\n \n" }, { "path": "tests/testsuite/rendering/html_blocks/src/script-in-block.md", "content": "
\n HTML block start\n\n < still in block\n
\n" }, { "path": "tests/testsuite/rendering.rs", "content": "//! Tests for HTML rendering.\n//!\n//! Note that markdown-specific rendering tests are in the `markdown` module.\n\nuse crate::prelude::*;\n\n// Checks that edit-url-template works.\n#[test]\nfn edit_url_template() {\n BookTest::from_dir(\"rendering/edit_url_template\").check_file_contains(\n \"book/index.html\",\n \"\",\n );\n}\n\n// Checks that an alternate `src` setting works with the edit url template.\n#[test]\nfn edit_url_template_explicit_src() {\n BookTest::from_dir(\"rendering/edit_url_template_explicit_src\").check_file_contains(\n \"book/index.html\",\n \"\",\n );\n}\n\n// Checks that index.html is generated correctly, even when the first few\n// chapters are drafts.\n#[test]\nfn first_chapter_is_copied_as_index_even_if_not_first_elem() {\n BookTest::from_dir(\"rendering/first_chapter_is_copied_as_index_even_if_not_first_elem\")\n // These two files should be equal.\n .check_main_file(\n \"book/chapter_1.html\",\n str![[\n r##\"

Chapter 1

\"##\n ]],\n )\n .check_main_file(\n \"book/index.html\",\n str![[\n r##\"

Chapter 1

\"##\n ]],\n );\n}\n\n// Fontawesome `` tag support.\n#[test]\nfn fontawesome() {\n BookTest::from_dir(\"rendering/fontawesome\")\n .run(\"build\", |cmd| {\n cmd.expect_stderr(str![[r#\"\n INFO Book building has started\n INFO Running the html backend\n WARN failed to find Font Awesome icon for icon `does-not-exist` with type `regular` in `fa.md`: Invalid Font Awesome icon name: visit https://fontawesome.com/icons?d=gallery&m=free to see valid names\n INFO HTML book written to `[ROOT]/book`\n\n\"#]]);\n })\n .check_all_main_files();\n}\n\n// Verifies that an invalid `git-repository-icon` in book.toml produces a\n// helpful error message with the icon name, type, and a link to FontAwesome.\n#[test]\nfn fontawesome_error_message() {\n BookTest::from_dir(\"rendering/fontawesome_error\")\n .run(\"build\", |cmd| {\n cmd.expect_failure();\n cmd.expect_stderr(str![[r#\"\n INFO Book building has started\n INFO Running the html backend\nERROR Rendering failed\n[TAB]Caused by: Error rendering \"index\" line [..], col [..]: Unknown Font Awesome icon `github` for type `regular`. Hint: check the icon name and prefix (fas (solid), fab (brands), or far (regular)) at https://fontawesome.com/v6/search?m=free\n[TAB]Caused by: Unknown Font Awesome icon `github` for type `regular`. Hint: check the icon name and prefix (fas (solid), fab (brands), or far (regular)) at https://fontawesome.com/v6/search?m=free\n\n\"#]]);\n });\n}\n\n// Tests the rendering when setting the default rust edition.\n#[test]\nfn default_rust_edition() {\n BookTest::from_dir(\"rendering/default_rust_edition\").check_all_main_files();\n}\n\n// Tests the rendering for editable code blocks.\n#[test]\nfn editable_rust_block() {\n BookTest::from_dir(\"rendering/editable_rust_block\").check_all_main_files();\n}\n\n// Tests for custom hide lines.\n#[test]\nfn hidelines() {\n BookTest::from_dir(\"rendering/hidelines\").check_all_main_files();\n}\n\n// Tests for code blocks of basic rust code.\n#[test]\nfn language_rust_playground() {\n fn expect(input: &str, info: &str, expected: impl snapbox::IntoData) {\n BookTest::init(|_| {})\n .change_file(\"book.toml\", \"output.html.playground.editable = true\")\n .change_file(\"src/chapter_1.md\", &format!(\"```rust {info}\\n{input}\\n```\"))\n .check_main_file(\"book/chapter_1.html\", expected);\n }\n // No-main should be wrapped in `fn main` boring lines.\n expect(\n \"x()\",\n \"\",\n str![[r#\"\n
#![allow(unused)]\nfn main() {\nx()\n}
\n\"#]],\n );\n // `fn main` should not be wrapped, not boring.\n expect(\n \"fn main() {}\",\n \"\",\n str![[r#\"
fn main() {}
\"#]],\n );\n // Lines starting with `#` are boring.\n expect(\n \"let s = \\\"foo\\n # bar\\n\\\";\",\n \"editable\",\n str![[r#\"\n
let s = \"foo\n bar\n\";
\n\"#]],\n );\n // `##` is not boring and is used as an escape.\n expect(\n \"let s = \\\"foo\\n ## bar\\n\\\";\",\n \"editable\",\n str![[r#\"\n
let s = \"foo\n # bar\n\";
\n\"#]],\n );\n // `#` on a line by itself is boring.\n expect(\n \"let s = \\\"foo\\n # bar\\n#\\n\\\";\",\n \"editable\",\n str![[r#\"\n
let s = \"foo\n bar\n\n\";
\n\"#]],\n );\n // `#` must be followed by a space to be boring.\n expect(\n \"#x;\",\n \"\",\n str![[r#\"\n
#![allow(unused)]\nfn main() {\n#x;\n}
\n\"#]],\n );\n\n // Other classes like \"ignore\" should not change things, and the class is\n // included in the code tag.\n expect(\n \"let s = \\\"foo\\n # bar\\n\\\";\",\n \"ignore\",\n str![[r#\"\n
let s = \"foo\n bar\n\";
\n\"#]],\n );\n // Inner attributes and normal attributes are not boring.\n expect(\n \"#![no_std]\\nlet s = \\\"foo\\\";\\n #[some_attr]\",\n \"editable\",\n str![[r#\"\n
#![no_std]\nlet s = \"foo\";\n #[some_attr]
\n\"#]],\n );\n}\n\n// Rust code block in a list.\n#[test]\nfn code_block_in_list() {\n BookTest::init(|_| {})\n .change_file(\n \"src/chapter_1.md\",\n r#\"- inside list\n\n ```rust\n fn foo() {\n let x = 1;\n }\n ```\n\"#,\n )\n .check_main_file(\n \"book/chapter_1.html\",\n str![[r#\"\n
    \n
  • \n

    inside list

    \n
    #![allow(unused)]\nfn main() {\nfn foo() {\n  let x = 1;\n}\n}
    \n
    • \n
\n\"#]],\n );\n}\n\n// Checks the rendering of links added to headers.\n#[test]\nfn header_links() {\n BookTest::from_dir(\"rendering/header_links\").check_all_main_files();\n}\n\n// A corrupted HTML end tag.\n#[test]\nfn busted_end_tag() {\n BookTest::init(|_| {})\n .change_file(\"src/chapter_1.md\", \"
xfooy
\")\n .run(\"build\", |cmd| {\n cmd.expect_stderr(str![[r#\"\n INFO Book building has started\n INFO Running the html backend\n WARN html parse error in `chapter_1.md`: Self-closing end tag\nHtml text was:\n
xfooy
\n INFO HTML book written to `[ROOT]/book`\n\n\"#]]);\n })\n .check_main_file(\"book/chapter_1.html\", str![\"
xfooy
\"]);\n}\n\n// Various html blocks.\n#[test]\nfn html_blocks() {\n BookTest::from_dir(\"rendering/html_blocks\").check_all_main_files();\n}\n\n// Test for a fenced code block that is also indented.\n#[test]\nfn code_block_fenced_with_indent() {\n BookTest::from_dir(\"rendering/code_blocks_fenced_with_indent\").check_all_main_files();\n}\n\n// Unclosed HTML tags.\n//\n// Note that the HTML parsing algorithm is much more complicated than what\n// this is checking.\n#[test]\nfn unclosed_html_tags() {\n BookTest::init(|_| {})\n .change_file(\"src/chapter_1.md\", \"
xfooxyz\")\n .run(\"build\", |cmd| {\n cmd.expect_stderr(str![[r#\"\n INFO Book building has started\n INFO Running the html backend\n WARN unclosed HTML tag `` found in `chapter_1.md`\n WARN unclosed HTML tag `` found in `chapter_1.md`\n WARN unclosed HTML tag `
` found in `chapter_1.md`\n INFO HTML book written to `[ROOT]/book`\n\n\"#]]);\n })\n .check_main_file(\n \"book/chapter_1.html\",\n str![\"
xfooxyz
\"],\n );\n}\n\n// Test for HTML tags out of sync.\n#[test]\nfn unbalanced_html_tags() {\n BookTest::init(|_| {})\n .change_file(\"src/chapter_1.md\", \"
xfoo
\")\n .run(\"build\", |cmd| {\n cmd.expect_stderr(str![[r#\"\n INFO Book building has started\n INFO Running the html backend\n WARN unexpected HTML end tag `
` found in `chapter_1.md`\nCheck that the HTML tags are properly balanced.\n WARN unclosed HTML tag `
` found in `chapter_1.md`\n INFO HTML book written to `[ROOT]/book`\n\n\"#]]);\n })\n .check_main_file(\"book/chapter_1.html\", str![\"
xfoo
\"]);\n}\n\n// Test for bug with unbalanced HTML handling in the heading.\n#[test]\nfn heading_with_unbalanced_html() {\n BookTest::init(|_| {})\n .change_file(\"src/chapter_1.md\", \"### Option\")\n .run(\"build\", |cmd| {\n cmd.expect_stderr(str![[r#\"\n INFO Book building has started\n INFO Running the html backend\n WARN unclosed HTML tag `` found in `chapter_1.md` while exiting Heading(H3)\nHTML tags must be closed before exiting a markdown element.\n INFO HTML book written to `[ROOT]/book`\n\n\"#]]);\n })\n .check_main_file(\n \"book/chapter_1.html\",\n str![[r##\"

Option

\"##]],\n );\n}\n" }, { "path": "tests/testsuite/search/chapter_settings_validation_error/book.toml", "content": "[book]\ntitle = \"Search Test\"\n\n[output.html.search.chapter]\n\"does-not-exist\" = { enable = false }\n" }, { "path": "tests/testsuite/search/chapter_settings_validation_error/src/SUMMARY.md", "content": "" }, { "path": "tests/testsuite/search/disable_search_chapter/book.toml", "content": "[book]\ntitle = \"disable_search_chapter\"\n\n[output.html.search.chapter]\n\"second\" = { enable = false }\n\"first/disable_me.md\" = { enable = false }\n" }, { "path": "tests/testsuite/search/disable_search_chapter/src/SUMMARY.md", "content": "# Summary\n\n- [Keep Me](first/keep_me.md)\n- [Disable Me](first/disable_me.md)\n- [Second](second.md)\n - [Second Nested](second/nested.md)\n" }, { "path": "tests/testsuite/search/disable_search_chapter/src/first/disable_me.md", "content": "# Disable Me\n" }, { "path": "tests/testsuite/search/disable_search_chapter/src/first/keep_me.md", "content": "# Keep Me\n" }, { "path": "tests/testsuite/search/disable_search_chapter/src/second/nested.md", "content": "# Second Nested\n" }, { "path": "tests/testsuite/search/disable_search_chapter/src/second.md", "content": "# Second\n" }, { "path": "tests/testsuite/search/reasonable_search_index/expected_index.js", "content": "window.search = Object.assign(window.search, JSON.parse('{\"doc_urls\":[\"intro.html#introduction\",\"intro.html#sneaky\",\"first/index.html#first-chapter\",\"first/index.html#some-section\",\"first/includes.html#includes\",\"first/includes.html#summary\",\"first/unicode.html#unicode-stress-tests\",\"first/no-headers.html\",\"first/duplicate-headers.html#duplicate-headers\",\"first/duplicate-headers.html#header-text\",\"first/duplicate-headers.html#header-text-1\",\"first/duplicate-headers.html#header-text-2\",\"first/heading-attributes.html#attrs\",\"first/heading-attributes.html#heading-with-classes\",\"first/heading-attributes.html#both\"],\"index\":{\"documentStore\":{\"docInfo\":{\"0\":{\"body\":3,\"breadcrumbs\":2,\"title\":1},\"1\":{\"body\":9,\"breadcrumbs\":2,\"title\":1},\"10\":{\"body\":0,\"breadcrumbs\":6,\"title\":2},\"11\":{\"body\":0,\"breadcrumbs\":6,\"title\":2},\"12\":{\"body\":0,\"breadcrumbs\":6,\"title\":2},\"13\":{\"body\":0,\"breadcrumbs\":6,\"title\":2},\"14\":{\"body\":0,\"breadcrumbs\":7,\"title\":3},\"2\":{\"body\":2,\"breadcrumbs\":4,\"title\":2},\"3\":{\"body\":0,\"breadcrumbs\":3,\"title\":1},\"4\":{\"body\":0,\"breadcrumbs\":4,\"title\":1},\"5\":{\"body\":10,\"breadcrumbs\":4,\"title\":1},\"6\":{\"body\":29,\"breadcrumbs\":6,\"title\":3},\"7\":{\"body\":6,\"breadcrumbs\":3,\"title\":2},\"8\":{\"body\":5,\"breadcrumbs\":6,\"title\":2},\"9\":{\"body\":0,\"breadcrumbs\":6,\"title\":2}},\"docs\":{\"0\":{\"body\":\"Here’s some interesting text…\",\"breadcrumbs\":\"Introduction » Introduction\",\"id\":\"0\",\"title\":\"Introduction\"},\"1\":{\"body\":\"I put in here! Sneaky inline event . But regular inline is indexed.\",\"breadcrumbs\":\"Introduction » Sneaky\",\"id\":\"1\",\"title\":\"Sneaky\"},\"10\":{\"body\":\"\",\"breadcrumbs\":\"First Chapter » Duplicate Headers » Header Text\",\"id\":\"10\",\"title\":\"Header Text\"},\"11\":{\"body\":\"\",\"breadcrumbs\":\"First Chapter » Duplicate Headers » header-text\",\"id\":\"11\",\"title\":\"header-text\"},\"12\":{\"body\":\"\",\"breadcrumbs\":\"First Chapter » Heading Attributes » Heading Attributes\",\"id\":\"12\",\"title\":\"Heading Attributes\"},\"13\":{\"body\":\"\",\"breadcrumbs\":\"First Chapter » Heading Attributes » Heading with classes\",\"id\":\"13\",\"title\":\"Heading with classes\"},\"14\":{\"body\":\"\",\"breadcrumbs\":\"First Chapter » Heading Attributes » Heading with id and classes\",\"id\":\"14\",\"title\":\"Heading with id and classes\"},\"2\":{\"body\":\"more text.\",\"breadcrumbs\":\"First Chapter » First Chapter\",\"id\":\"2\",\"title\":\"First Chapter\"},\"3\":{\"body\":\"\",\"breadcrumbs\":\"First Chapter » Some Section\",\"id\":\"3\",\"title\":\"Some Section\"},\"4\":{\"body\":\"\",\"breadcrumbs\":\"First Chapter » Includes » Includes\",\"id\":\"4\",\"title\":\"Includes\"},\"5\":{\"body\":\"Introduction First Chapter Includes Unicode No Headers Duplicate Headers Heading Attributes\",\"breadcrumbs\":\"First Chapter » Includes » Summary\",\"id\":\"5\",\"title\":\"Summary\"},\"6\":{\"body\":\"Please be careful editing, this contains carefully crafted characters. Two byte character: spatiëring Combining character: spatiëring Three byte character: 书こんにちは Four byte character: 𐌀‮𐌁‮𐌂‮𐌃‮𐌄‮𐌅‮𐌆‮𐌇‮𐌈‬ Right-to-left: مرحبا Emoticons: 🔊 😍 💜 1️⃣ right-to-left mark: hello באמת!‏ Zalgo: ǫ̛̖̱̗̝͈̋͒͋̏ͥͫ̒̆ͩ̏͌̾͊͐ͪ̾̚\",\"breadcrumbs\":\"First Chapter » Unicode » Unicode stress tests\",\"id\":\"6\",\"title\":\"Unicode stress tests\"},\"7\":{\"body\":\"Capybara capybara capybara. Capybara capybara capybara. ThisLongWordIsIncludedSoWeCanCheckThatSufficientlyLongWordsAreOmittedFromTheSearchIndex.\",\"breadcrumbs\":\"First Chapter » No Headers\",\"id\":\"7\",\"title\":\"First Chapter\"},\"8\":{\"body\":\"This page validates behaviour of duplicate headers.\",\"breadcrumbs\":\"First Chapter » Duplicate Headers » Duplicate headers\",\"id\":\"8\",\"title\":\"Duplicate headers\"},\"9\":{\"body\":\"\",\"breadcrumbs\":\"First Chapter » Duplicate Headers » Header Text\",\"id\":\"9\",\"title\":\"Header Text\"}},\"length\":15,\"save\":true},\"fields\":[\"title\",\"body\",\"breadcrumbs\"],\"index\":{\"body\":{\"root\":{\"1\":{\"df\":1,\"docs\":{\"6\":{\"tf\":1.0}}},\"a\":{\"df\":0,\"docs\":{},\"t\":{\"df\":0,\"docs\":{},\"t\":{\"df\":0,\"docs\":{},\"r\":{\"df\":0,\"docs\":{},\"i\":{\"b\":{\"df\":0,\"docs\":{},\"u\":{\"df\":0,\"docs\":{},\"t\":{\"df\":2,\"docs\":{\"12\":{\"tf\":1.0},\"5\":{\"tf\":1.0}}}}},\"df\":0,\"docs\":{}}}}}},\"b\":{\"df\":0,\"docs\":{},\"e\":{\"df\":0,\"docs\":{},\"h\":{\"a\":{\"df\":0,\"docs\":{},\"v\":{\"df\":0,\"docs\":{},\"i\":{\"df\":0,\"docs\":{},\"o\":{\"df\":0,\"docs\":{},\"u\":{\"df\":0,\"docs\":{},\"r\":{\"df\":1,\"docs\":{\"8\":{\"tf\":1.0}}}}}}}},\"df\":0,\"docs\":{}}},\"y\":{\"df\":0,\"docs\":{},\"t\":{\"df\":0,\"docs\":{},\"e\":{\"df\":1,\"docs\":{\"6\":{\"tf\":1.7320508075688772}}}}}},\"c\":{\"a\":{\"df\":0,\"docs\":{},\"p\":{\"df\":0,\"docs\":{},\"y\":{\"b\":{\"a\":{\"df\":0,\"docs\":{},\"r\":{\"a\":{\"df\":1,\"docs\":{\"7\":{\"tf\":2.449489742783178}}},\"df\":0,\"docs\":{}}},\"df\":0,\"docs\":{}},\"df\":0,\"docs\":{}}},\"r\":{\"df\":0,\"docs\":{},\"e\":{\"df\":1,\"docs\":{\"6\":{\"tf\":1.0}},\"f\":{\"df\":0,\"docs\":{},\"u\":{\"df\":0,\"docs\":{},\"l\":{\"df\":0,\"docs\":{},\"l\":{\"df\":0,\"docs\":{},\"i\":{\"df\":1,\"docs\":{\"6\":{\"tf\":1.0}}}}}}}}}},\"df\":0,\"docs\":{},\"h\":{\"a\":{\"df\":0,\"docs\":{},\"p\":{\"df\":0,\"docs\":{},\"t\":{\"df\":0,\"docs\":{},\"e\":{\"df\":0,\"docs\":{},\"r\":{\"df\":3,\"docs\":{\"2\":{\"tf\":1.0},\"5\":{\"tf\":1.0},\"7\":{\"tf\":1.0}}}}}},\"r\":{\"a\":{\"c\":{\"df\":0,\"docs\":{},\"t\":{\"df\":1,\"docs\":{\"6\":{\"tf\":2.23606797749979}}}},\"df\":0,\"docs\":{}},\"df\":0,\"docs\":{}}},\"df\":0,\"docs\":{}},\"l\":{\"a\":{\"df\":0,\"docs\":{},\"s\":{\"df\":0,\"docs\":{},\"s\":{\"df\":2,\"docs\":{\"13\":{\"tf\":1.0},\"14\":{\"tf\":1.0}}}}},\"df\":0,\"docs\":{}},\"o\":{\"df\":0,\"docs\":{},\"m\":{\"b\":{\"df\":0,\"docs\":{},\"i\":{\"df\":0,\"docs\":{},\"n\":{\"df\":1,\"docs\":{\"6\":{\"tf\":1.0}}}}},\"df\":0,\"docs\":{}},\"n\":{\"df\":0,\"docs\":{},\"t\":{\"a\":{\"df\":0,\"docs\":{},\"i\":{\"df\":0,\"docs\":{},\"n\":{\"df\":1,\"docs\":{\"6\":{\"tf\":1.0}}}}},\"df\":0,\"docs\":{}}}},\"r\":{\"a\":{\"df\":0,\"docs\":{},\"f\":{\"df\":0,\"docs\":{},\"t\":{\"df\":1,\"docs\":{\"6\":{\"tf\":1.0}}}}},\"df\":0,\"docs\":{}}},\"d\":{\"df\":0,\"docs\":{},\"u\":{\"df\":0,\"docs\":{},\"p\":{\"df\":0,\"docs\":{},\"l\":{\"df\":0,\"docs\":{},\"i\":{\"c\":{\"df\":2,\"docs\":{\"5\":{\"tf\":1.0},\"8\":{\"tf\":1.4142135623730951}}},\"df\":0,\"docs\":{}}}}}},\"df\":0,\"docs\":{},\"e\":{\"d\":{\"df\":0,\"docs\":{},\"i\":{\"df\":0,\"docs\":{},\"t\":{\"df\":1,\"docs\":{\"6\":{\"tf\":1.0}}}}},\"df\":0,\"docs\":{},\"m\":{\"df\":0,\"docs\":{},\"o\":{\"df\":0,\"docs\":{},\"t\":{\"df\":0,\"docs\":{},\"i\":{\"c\":{\"df\":0,\"docs\":{},\"o\":{\"df\":0,\"docs\":{},\"n\":{\"df\":1,\"docs\":{\"6\":{\"tf\":1.0}}}}},\"df\":0,\"docs\":{}}}}},\"v\":{\"df\":0,\"docs\":{},\"e\":{\"df\":0,\"docs\":{},\"n\":{\"df\":0,\"docs\":{},\"t\":{\"df\":1,\"docs\":{\"1\":{\"tf\":1.0}}}}}}},\"f\":{\"df\":0,\"docs\":{},\"i\":{\"df\":0,\"docs\":{},\"r\":{\"df\":0,\"docs\":{},\"s\":{\"df\":0,\"docs\":{},\"t\":{\"df\":3,\"docs\":{\"2\":{\"tf\":1.0},\"5\":{\"tf\":1.0},\"7\":{\"tf\":1.0}}}}}},\"o\":{\"df\":0,\"docs\":{},\"u\":{\"df\":0,\"docs\":{},\"r\":{\"df\":1,\"docs\":{\"6\":{\"tf\":1.0}}}}}},\"h\":{\"df\":0,\"docs\":{},\"e\":{\"a\":{\"d\":{\"df\":4,\"docs\":{\"12\":{\"tf\":1.0},\"13\":{\"tf\":1.0},\"14\":{\"tf\":1.0},\"5\":{\"tf\":1.0}},\"e\":{\"df\":0,\"docs\":{},\"r\":{\"df\":5,\"docs\":{\"10\":{\"tf\":1.0},\"11\":{\"tf\":1.0},\"5\":{\"tf\":1.4142135623730951},\"8\":{\"tf\":1.4142135623730951},\"9\":{\"tf\":1.0}}}}},\"df\":0,\"docs\":{}},\"df\":0,\"docs\":{},\"l\":{\"df\":0,\"docs\":{},\"l\":{\"df\":0,\"docs\":{},\"o\":{\"df\":1,\"docs\":{\"6\":{\"tf\":1.0}}}}},\"r\":{\"df\":0,\"docs\":{},\"e\":{\"df\":1,\"docs\":{\"1\":{\"tf\":1.0}},\"’\":{\"df\":1,\"docs\":{\"0\":{\"tf\":1.0}}}}}},\"t\":{\"df\":0,\"docs\":{},\"m\":{\"df\":0,\"docs\":{},\"l\":{\"df\":1,\"docs\":{\"1\":{\"tf\":1.0}}}}}},\"i\":{\"d\":{\"df\":1,\"docs\":{\"14\":{\"tf\":1.0}}},\"df\":0,\"docs\":{},\"n\":{\"c\":{\"df\":0,\"docs\":{},\"l\":{\"df\":0,\"docs\":{},\"u\":{\"d\":{\"df\":2,\"docs\":{\"4\":{\"tf\":1.0},\"5\":{\"tf\":1.0}}},\"df\":0,\"docs\":{}}}},\"d\":{\"df\":0,\"docs\":{},\"e\":{\"df\":0,\"docs\":{},\"x\":{\"df\":1,\"docs\":{\"1\":{\"tf\":1.0}}}}},\"df\":0,\"docs\":{},\"l\":{\"df\":0,\"docs\":{},\"i\":{\"df\":0,\"docs\":{},\"n\":{\"df\":1,\"docs\":{\"1\":{\"tf\":1.4142135623730951}}}}},\"t\":{\"df\":0,\"docs\":{},\"e\":{\"df\":0,\"docs\":{},\"r\":{\"df\":0,\"docs\":{},\"e\":{\"df\":0,\"docs\":{},\"s\":{\"df\":0,\"docs\":{},\"t\":{\"df\":1,\"docs\":{\"0\":{\"tf\":1.0}}}}}}},\"r\":{\"df\":0,\"docs\":{},\"o\":{\"d\":{\"df\":0,\"docs\":{},\"u\":{\"c\":{\"df\":0,\"docs\":{},\"t\":{\"df\":2,\"docs\":{\"0\":{\"tf\":1.0},\"5\":{\"tf\":1.0}}}},\"df\":0,\"docs\":{}}},\"df\":0,\"docs\":{}}}}}},\"l\":{\"df\":0,\"docs\":{},\"e\":{\"df\":0,\"docs\":{},\"f\":{\"df\":0,\"docs\":{},\"t\":{\"df\":1,\"docs\":{\"6\":{\"tf\":1.4142135623730951}}}}}},\"m\":{\"a\":{\"df\":0,\"docs\":{},\"r\":{\"df\":0,\"docs\":{},\"k\":{\"df\":1,\"docs\":{\"6\":{\"tf\":1.0}}}}},\"df\":0,\"docs\":{},\"o\":{\"df\":0,\"docs\":{},\"r\":{\"df\":0,\"docs\":{},\"e\":{\"df\":1,\"docs\":{\"2\":{\"tf\":1.0}}}}}},\"p\":{\"a\":{\"df\":0,\"docs\":{},\"g\":{\"df\":0,\"docs\":{},\"e\":{\"df\":1,\"docs\":{\"8\":{\"tf\":1.0}}}}},\"df\":0,\"docs\":{},\"l\":{\"df\":0,\"docs\":{},\"e\":{\"a\":{\"df\":0,\"docs\":{},\"s\":{\"df\":1,\"docs\":{\"6\":{\"tf\":1.0}}}},\"df\":0,\"docs\":{}}},\"u\":{\"df\":0,\"docs\":{},\"t\":{\"df\":1,\"docs\":{\"1\":{\"tf\":1.0}}}}},\"r\":{\"df\":0,\"docs\":{},\"e\":{\"df\":0,\"docs\":{},\"g\":{\"df\":0,\"docs\":{},\"u\":{\"df\":0,\"docs\":{},\"l\":{\"a\":{\"df\":0,\"docs\":{},\"r\":{\"df\":1,\"docs\":{\"1\":{\"tf\":1.0}}}},\"df\":0,\"docs\":{}}}}},\"i\":{\"df\":0,\"docs\":{},\"g\":{\"df\":0,\"docs\":{},\"h\":{\"df\":0,\"docs\":{},\"t\":{\"df\":1,\"docs\":{\"6\":{\"tf\":1.4142135623730951}}}}}}},\"s\":{\"df\":0,\"docs\":{},\"e\":{\"c\":{\"df\":0,\"docs\":{},\"t\":{\"df\":0,\"docs\":{},\"i\":{\"df\":0,\"docs\":{},\"o\":{\"df\":0,\"docs\":{},\"n\":{\"df\":1,\"docs\":{\"3\":{\"tf\":1.0}}}}}}},\"df\":0,\"docs\":{}},\"n\":{\"df\":0,\"docs\":{},\"e\":{\"a\":{\"df\":0,\"docs\":{},\"k\":{\"df\":0,\"docs\":{},\"i\":{\"df\":1,\"docs\":{\"1\":{\"tf\":1.4142135623730951}}}}},\"df\":0,\"docs\":{}}},\"p\":{\"a\":{\"df\":0,\"docs\":{},\"t\":{\"df\":0,\"docs\":{},\"i\":{\"df\":0,\"docs\":{},\"e\":{\"df\":0,\"docs\":{},\"̈\":{\"df\":0,\"docs\":{},\"r\":{\"df\":1,\"docs\":{\"6\":{\"tf\":1.0}}}}},\"ë\":{\"df\":0,\"docs\":{},\"r\":{\"df\":1,\"docs\":{\"6\":{\"tf\":1.0}}}}}}},\"df\":0,\"docs\":{}},\"t\":{\"df\":0,\"docs\":{},\"r\":{\"df\":0,\"docs\":{},\"e\":{\"df\":0,\"docs\":{},\"s\":{\"df\":0,\"docs\":{},\"s\":{\"df\":1,\"docs\":{\"6\":{\"tf\":1.0}}}}}}},\"u\":{\"df\":0,\"docs\":{},\"m\":{\"df\":0,\"docs\":{},\"m\":{\"a\":{\"df\":0,\"docs\":{},\"r\":{\"df\":0,\"docs\":{},\"i\":{\"df\":1,\"docs\":{\"5\":{\"tf\":1.0}}}}},\"df\":0,\"docs\":{}}}}},\"t\":{\"df\":0,\"docs\":{},\"e\":{\"df\":0,\"docs\":{},\"s\":{\"df\":0,\"docs\":{},\"t\":{\"df\":1,\"docs\":{\"6\":{\"tf\":1.0}}}},\"x\":{\"df\":0,\"docs\":{},\"t\":{\"df\":5,\"docs\":{\"0\":{\"tf\":1.0},\"10\":{\"tf\":1.0},\"11\":{\"tf\":1.0},\"2\":{\"tf\":1.0},\"9\":{\"tf\":1.0}}}}},\"h\":{\"df\":0,\"docs\":{},\"r\":{\"df\":0,\"docs\":{},\"e\":{\"df\":0,\"docs\":{},\"e\":{\"df\":1,\"docs\":{\"6\":{\"tf\":1.0}}}}}},\"w\":{\"df\":0,\"docs\":{},\"o\":{\"df\":1,\"docs\":{\"6\":{\"tf\":1.0}}}}},\"u\":{\"df\":0,\"docs\":{},\"n\":{\"df\":0,\"docs\":{},\"i\":{\"c\":{\"df\":0,\"docs\":{},\"o\":{\"d\":{\"df\":2,\"docs\":{\"5\":{\"tf\":1.0},\"6\":{\"tf\":1.0}}},\"df\":0,\"docs\":{}}},\"df\":0,\"docs\":{}}}},\"v\":{\"a\":{\"df\":0,\"docs\":{},\"l\":{\"df\":0,\"docs\":{},\"i\":{\"d\":{\"df\":1,\"docs\":{\"8\":{\"tf\":1.0}}},\"df\":0,\"docs\":{}}}},\"df\":0,\"docs\":{}},\"z\":{\"a\":{\"df\":0,\"docs\":{},\"l\":{\"df\":0,\"docs\":{},\"g\":{\"df\":0,\"docs\":{},\"o\":{\"df\":1,\"docs\":{\"6\":{\"tf\":1.0}}}}}},\"df\":0,\"docs\":{}}}},\"breadcrumbs\":{\"root\":{\"1\":{\"df\":1,\"docs\":{\"6\":{\"tf\":1.0}}},\"a\":{\"df\":0,\"docs\":{},\"t\":{\"df\":0,\"docs\":{},\"t\":{\"df\":0,\"docs\":{},\"r\":{\"df\":0,\"docs\":{},\"i\":{\"b\":{\"df\":0,\"docs\":{},\"u\":{\"df\":0,\"docs\":{},\"t\":{\"df\":4,\"docs\":{\"12\":{\"tf\":1.7320508075688772},\"13\":{\"tf\":1.0},\"14\":{\"tf\":1.0},\"5\":{\"tf\":1.0}}}}},\"df\":0,\"docs\":{}}}}}},\"b\":{\"df\":0,\"docs\":{},\"e\":{\"df\":0,\"docs\":{},\"h\":{\"a\":{\"df\":0,\"docs\":{},\"v\":{\"df\":0,\"docs\":{},\"i\":{\"df\":0,\"docs\":{},\"o\":{\"df\":0,\"docs\":{},\"u\":{\"df\":0,\"docs\":{},\"r\":{\"df\":1,\"docs\":{\"8\":{\"tf\":1.0}}}}}}}},\"df\":0,\"docs\":{}}},\"y\":{\"df\":0,\"docs\":{},\"t\":{\"df\":0,\"docs\":{},\"e\":{\"df\":1,\"docs\":{\"6\":{\"tf\":1.7320508075688772}}}}}},\"c\":{\"a\":{\"df\":0,\"docs\":{},\"p\":{\"df\":0,\"docs\":{},\"y\":{\"b\":{\"a\":{\"df\":0,\"docs\":{},\"r\":{\"a\":{\"df\":1,\"docs\":{\"7\":{\"tf\":2.449489742783178}}},\"df\":0,\"docs\":{}}},\"df\":0,\"docs\":{}},\"df\":0,\"docs\":{}}},\"r\":{\"df\":0,\"docs\":{},\"e\":{\"df\":1,\"docs\":{\"6\":{\"tf\":1.0}},\"f\":{\"df\":0,\"docs\":{},\"u\":{\"df\":0,\"docs\":{},\"l\":{\"df\":0,\"docs\":{},\"l\":{\"df\":0,\"docs\":{},\"i\":{\"df\":1,\"docs\":{\"6\":{\"tf\":1.0}}}}}}}}}},\"df\":0,\"docs\":{},\"h\":{\"a\":{\"df\":0,\"docs\":{},\"p\":{\"df\":0,\"docs\":{},\"t\":{\"df\":0,\"docs\":{},\"e\":{\"df\":0,\"docs\":{},\"r\":{\"df\":13,\"docs\":{\"10\":{\"tf\":1.0},\"11\":{\"tf\":1.0},\"12\":{\"tf\":1.0},\"13\":{\"tf\":1.0},\"14\":{\"tf\":1.0},\"2\":{\"tf\":1.7320508075688772},\"3\":{\"tf\":1.0},\"4\":{\"tf\":1.0},\"5\":{\"tf\":1.4142135623730951},\"6\":{\"tf\":1.0},\"7\":{\"tf\":1.4142135623730951},\"8\":{\"tf\":1.0},\"9\":{\"tf\":1.0}}}}}},\"r\":{\"a\":{\"c\":{\"df\":0,\"docs\":{},\"t\":{\"df\":1,\"docs\":{\"6\":{\"tf\":2.23606797749979}}}},\"df\":0,\"docs\":{}},\"df\":0,\"docs\":{}}},\"df\":0,\"docs\":{}},\"l\":{\"a\":{\"df\":0,\"docs\":{},\"s\":{\"df\":0,\"docs\":{},\"s\":{\"df\":2,\"docs\":{\"13\":{\"tf\":1.4142135623730951},\"14\":{\"tf\":1.4142135623730951}}}}},\"df\":0,\"docs\":{}},\"o\":{\"df\":0,\"docs\":{},\"m\":{\"b\":{\"df\":0,\"docs\":{},\"i\":{\"df\":0,\"docs\":{},\"n\":{\"df\":1,\"docs\":{\"6\":{\"tf\":1.0}}}}},\"df\":0,\"docs\":{}},\"n\":{\"df\":0,\"docs\":{},\"t\":{\"a\":{\"df\":0,\"docs\":{},\"i\":{\"df\":0,\"docs\":{},\"n\":{\"df\":1,\"docs\":{\"6\":{\"tf\":1.0}}}}},\"df\":0,\"docs\":{}}}},\"r\":{\"a\":{\"df\":0,\"docs\":{},\"f\":{\"df\":0,\"docs\":{},\"t\":{\"df\":1,\"docs\":{\"6\":{\"tf\":1.0}}}}},\"df\":0,\"docs\":{}}},\"d\":{\"df\":0,\"docs\":{},\"u\":{\"df\":0,\"docs\":{},\"p\":{\"df\":0,\"docs\":{},\"l\":{\"df\":0,\"docs\":{},\"i\":{\"c\":{\"df\":5,\"docs\":{\"10\":{\"tf\":1.0},\"11\":{\"tf\":1.0},\"5\":{\"tf\":1.0},\"8\":{\"tf\":2.0},\"9\":{\"tf\":1.0}}},\"df\":0,\"docs\":{}}}}}},\"df\":0,\"docs\":{},\"e\":{\"d\":{\"df\":0,\"docs\":{},\"i\":{\"df\":0,\"docs\":{},\"t\":{\"df\":1,\"docs\":{\"6\":{\"tf\":1.0}}}}},\"df\":0,\"docs\":{},\"m\":{\"df\":0,\"docs\":{},\"o\":{\"df\":0,\"docs\":{},\"t\":{\"df\":0,\"docs\":{},\"i\":{\"c\":{\"df\":0,\"docs\":{},\"o\":{\"df\":0,\"docs\":{},\"n\":{\"df\":1,\"docs\":{\"6\":{\"tf\":1.0}}}}},\"df\":0,\"docs\":{}}}}},\"v\":{\"df\":0,\"docs\":{},\"e\":{\"df\":0,\"docs\":{},\"n\":{\"df\":0,\"docs\":{},\"t\":{\"df\":1,\"docs\":{\"1\":{\"tf\":1.0}}}}}}},\"f\":{\"df\":0,\"docs\":{},\"i\":{\"df\":0,\"docs\":{},\"r\":{\"df\":0,\"docs\":{},\"s\":{\"df\":0,\"docs\":{},\"t\":{\"df\":13,\"docs\":{\"10\":{\"tf\":1.0},\"11\":{\"tf\":1.0},\"12\":{\"tf\":1.0},\"13\":{\"tf\":1.0},\"14\":{\"tf\":1.0},\"2\":{\"tf\":1.7320508075688772},\"3\":{\"tf\":1.0},\"4\":{\"tf\":1.0},\"5\":{\"tf\":1.4142135623730951},\"6\":{\"tf\":1.0},\"7\":{\"tf\":1.4142135623730951},\"8\":{\"tf\":1.0},\"9\":{\"tf\":1.0}}}}}},\"o\":{\"df\":0,\"docs\":{},\"u\":{\"df\":0,\"docs\":{},\"r\":{\"df\":1,\"docs\":{\"6\":{\"tf\":1.0}}}}}},\"h\":{\"df\":0,\"docs\":{},\"e\":{\"a\":{\"d\":{\"df\":4,\"docs\":{\"12\":{\"tf\":1.7320508075688772},\"13\":{\"tf\":1.7320508075688772},\"14\":{\"tf\":1.7320508075688772},\"5\":{\"tf\":1.0}},\"e\":{\"df\":0,\"docs\":{},\"r\":{\"df\":6,\"docs\":{\"10\":{\"tf\":1.7320508075688772},\"11\":{\"tf\":1.7320508075688772},\"5\":{\"tf\":1.4142135623730951},\"7\":{\"tf\":1.0},\"8\":{\"tf\":2.0},\"9\":{\"tf\":1.7320508075688772}}}}},\"df\":0,\"docs\":{}},\"df\":0,\"docs\":{},\"l\":{\"df\":0,\"docs\":{},\"l\":{\"df\":0,\"docs\":{},\"o\":{\"df\":1,\"docs\":{\"6\":{\"tf\":1.0}}}}},\"r\":{\"df\":0,\"docs\":{},\"e\":{\"df\":1,\"docs\":{\"1\":{\"tf\":1.0}},\"’\":{\"df\":1,\"docs\":{\"0\":{\"tf\":1.0}}}}}},\"t\":{\"df\":0,\"docs\":{},\"m\":{\"df\":0,\"docs\":{},\"l\":{\"df\":1,\"docs\":{\"1\":{\"tf\":1.0}}}}}},\"i\":{\"d\":{\"df\":1,\"docs\":{\"14\":{\"tf\":1.4142135623730951}}},\"df\":0,\"docs\":{},\"n\":{\"c\":{\"df\":0,\"docs\":{},\"l\":{\"df\":0,\"docs\":{},\"u\":{\"d\":{\"df\":2,\"docs\":{\"4\":{\"tf\":1.7320508075688772},\"5\":{\"tf\":1.4142135623730951}}},\"df\":0,\"docs\":{}}}},\"d\":{\"df\":0,\"docs\":{},\"e\":{\"df\":0,\"docs\":{},\"x\":{\"df\":1,\"docs\":{\"1\":{\"tf\":1.0}}}}},\"df\":0,\"docs\":{},\"l\":{\"df\":0,\"docs\":{},\"i\":{\"df\":0,\"docs\":{},\"n\":{\"df\":1,\"docs\":{\"1\":{\"tf\":1.4142135623730951}}}}},\"t\":{\"df\":0,\"docs\":{},\"e\":{\"df\":0,\"docs\":{},\"r\":{\"df\":0,\"docs\":{},\"e\":{\"df\":0,\"docs\":{},\"s\":{\"df\":0,\"docs\":{},\"t\":{\"df\":1,\"docs\":{\"0\":{\"tf\":1.0}}}}}}},\"r\":{\"df\":0,\"docs\":{},\"o\":{\"d\":{\"df\":0,\"docs\":{},\"u\":{\"c\":{\"df\":0,\"docs\":{},\"t\":{\"df\":3,\"docs\":{\"0\":{\"tf\":1.7320508075688772},\"1\":{\"tf\":1.0},\"5\":{\"tf\":1.0}}}},\"df\":0,\"docs\":{}}},\"df\":0,\"docs\":{}}}}}},\"l\":{\"df\":0,\"docs\":{},\"e\":{\"df\":0,\"docs\":{},\"f\":{\"df\":0,\"docs\":{},\"t\":{\"df\":1,\"docs\":{\"6\":{\"tf\":1.4142135623730951}}}}}},\"m\":{\"a\":{\"df\":0,\"docs\":{},\"r\":{\"df\":0,\"docs\":{},\"k\":{\"df\":1,\"docs\":{\"6\":{\"tf\":1.0}}}}},\"df\":0,\"docs\":{},\"o\":{\"df\":0,\"docs\":{},\"r\":{\"df\":0,\"docs\":{},\"e\":{\"df\":1,\"docs\":{\"2\":{\"tf\":1.0}}}}}},\"p\":{\"a\":{\"df\":0,\"docs\":{},\"g\":{\"df\":0,\"docs\":{},\"e\":{\"df\":1,\"docs\":{\"8\":{\"tf\":1.0}}}}},\"df\":0,\"docs\":{},\"l\":{\"df\":0,\"docs\":{},\"e\":{\"a\":{\"df\":0,\"docs\":{},\"s\":{\"df\":1,\"docs\":{\"6\":{\"tf\":1.0}}}},\"df\":0,\"docs\":{}}},\"u\":{\"df\":0,\"docs\":{},\"t\":{\"df\":1,\"docs\":{\"1\":{\"tf\":1.0}}}}},\"r\":{\"df\":0,\"docs\":{},\"e\":{\"df\":0,\"docs\":{},\"g\":{\"df\":0,\"docs\":{},\"u\":{\"df\":0,\"docs\":{},\"l\":{\"a\":{\"df\":0,\"docs\":{},\"r\":{\"df\":1,\"docs\":{\"1\":{\"tf\":1.0}}}},\"df\":0,\"docs\":{}}}}},\"i\":{\"df\":0,\"docs\":{},\"g\":{\"df\":0,\"docs\":{},\"h\":{\"df\":0,\"docs\":{},\"t\":{\"df\":1,\"docs\":{\"6\":{\"tf\":1.4142135623730951}}}}}}},\"s\":{\"df\":0,\"docs\":{},\"e\":{\"c\":{\"df\":0,\"docs\":{},\"t\":{\"df\":0,\"docs\":{},\"i\":{\"df\":0,\"docs\":{},\"o\":{\"df\":0,\"docs\":{},\"n\":{\"df\":1,\"docs\":{\"3\":{\"tf\":1.4142135623730951}}}}}}},\"df\":0,\"docs\":{}},\"n\":{\"df\":0,\"docs\":{},\"e\":{\"a\":{\"df\":0,\"docs\":{},\"k\":{\"df\":0,\"docs\":{},\"i\":{\"df\":1,\"docs\":{\"1\":{\"tf\":1.7320508075688772}}}}},\"df\":0,\"docs\":{}}},\"p\":{\"a\":{\"df\":0,\"docs\":{},\"t\":{\"df\":0,\"docs\":{},\"i\":{\"df\":0,\"docs\":{},\"e\":{\"df\":0,\"docs\":{},\"̈\":{\"df\":0,\"docs\":{},\"r\":{\"df\":1,\"docs\":{\"6\":{\"tf\":1.0}}}}},\"ë\":{\"df\":0,\"docs\":{},\"r\":{\"df\":1,\"docs\":{\"6\":{\"tf\":1.0}}}}}}},\"df\":0,\"docs\":{}},\"t\":{\"df\":0,\"docs\":{},\"r\":{\"df\":0,\"docs\":{},\"e\":{\"df\":0,\"docs\":{},\"s\":{\"df\":0,\"docs\":{},\"s\":{\"df\":1,\"docs\":{\"6\":{\"tf\":1.4142135623730951}}}}}}},\"u\":{\"df\":0,\"docs\":{},\"m\":{\"df\":0,\"docs\":{},\"m\":{\"a\":{\"df\":0,\"docs\":{},\"r\":{\"df\":0,\"docs\":{},\"i\":{\"df\":1,\"docs\":{\"5\":{\"tf\":1.4142135623730951}}}}},\"df\":0,\"docs\":{}}}}},\"t\":{\"df\":0,\"docs\":{},\"e\":{\"df\":0,\"docs\":{},\"s\":{\"df\":0,\"docs\":{},\"t\":{\"df\":1,\"docs\":{\"6\":{\"tf\":1.4142135623730951}}}},\"x\":{\"df\":0,\"docs\":{},\"t\":{\"df\":5,\"docs\":{\"0\":{\"tf\":1.0},\"10\":{\"tf\":1.4142135623730951},\"11\":{\"tf\":1.4142135623730951},\"2\":{\"tf\":1.0},\"9\":{\"tf\":1.4142135623730951}}}}},\"h\":{\"df\":0,\"docs\":{},\"r\":{\"df\":0,\"docs\":{},\"e\":{\"df\":0,\"docs\":{},\"e\":{\"df\":1,\"docs\":{\"6\":{\"tf\":1.0}}}}}},\"w\":{\"df\":0,\"docs\":{},\"o\":{\"df\":1,\"docs\":{\"6\":{\"tf\":1.0}}}}},\"u\":{\"df\":0,\"docs\":{},\"n\":{\"df\":0,\"docs\":{},\"i\":{\"c\":{\"df\":0,\"docs\":{},\"o\":{\"d\":{\"df\":2,\"docs\":{\"5\":{\"tf\":1.0},\"6\":{\"tf\":1.7320508075688772}}},\"df\":0,\"docs\":{}}},\"df\":0,\"docs\":{}}}},\"v\":{\"a\":{\"df\":0,\"docs\":{},\"l\":{\"df\":0,\"docs\":{},\"i\":{\"d\":{\"df\":1,\"docs\":{\"8\":{\"tf\":1.0}}},\"df\":0,\"docs\":{}}}},\"df\":0,\"docs\":{}},\"z\":{\"a\":{\"df\":0,\"docs\":{},\"l\":{\"df\":0,\"docs\":{},\"g\":{\"df\":0,\"docs\":{},\"o\":{\"df\":1,\"docs\":{\"6\":{\"tf\":1.0}}}}}},\"df\":0,\"docs\":{}}}},\"title\":{\"root\":{\"a\":{\"df\":0,\"docs\":{},\"t\":{\"df\":0,\"docs\":{},\"t\":{\"df\":0,\"docs\":{},\"r\":{\"df\":0,\"docs\":{},\"i\":{\"b\":{\"df\":0,\"docs\":{},\"u\":{\"df\":0,\"docs\":{},\"t\":{\"df\":1,\"docs\":{\"12\":{\"tf\":1.0}}}}},\"df\":0,\"docs\":{}}}}}},\"c\":{\"df\":0,\"docs\":{},\"h\":{\"a\":{\"df\":0,\"docs\":{},\"p\":{\"df\":0,\"docs\":{},\"t\":{\"df\":0,\"docs\":{},\"e\":{\"df\":0,\"docs\":{},\"r\":{\"df\":2,\"docs\":{\"2\":{\"tf\":1.0},\"7\":{\"tf\":1.0}}}}}}},\"df\":0,\"docs\":{}},\"l\":{\"a\":{\"df\":0,\"docs\":{},\"s\":{\"df\":0,\"docs\":{},\"s\":{\"df\":2,\"docs\":{\"13\":{\"tf\":1.0},\"14\":{\"tf\":1.0}}}}},\"df\":0,\"docs\":{}}},\"d\":{\"df\":0,\"docs\":{},\"u\":{\"df\":0,\"docs\":{},\"p\":{\"df\":0,\"docs\":{},\"l\":{\"df\":0,\"docs\":{},\"i\":{\"c\":{\"df\":1,\"docs\":{\"8\":{\"tf\":1.0}}},\"df\":0,\"docs\":{}}}}}},\"df\":0,\"docs\":{},\"f\":{\"df\":0,\"docs\":{},\"i\":{\"df\":0,\"docs\":{},\"r\":{\"df\":0,\"docs\":{},\"s\":{\"df\":0,\"docs\":{},\"t\":{\"df\":2,\"docs\":{\"2\":{\"tf\":1.0},\"7\":{\"tf\":1.0}}}}}}},\"h\":{\"df\":0,\"docs\":{},\"e\":{\"a\":{\"d\":{\"df\":3,\"docs\":{\"12\":{\"tf\":1.0},\"13\":{\"tf\":1.0},\"14\":{\"tf\":1.0}},\"e\":{\"df\":0,\"docs\":{},\"r\":{\"df\":4,\"docs\":{\"10\":{\"tf\":1.0},\"11\":{\"tf\":1.0},\"8\":{\"tf\":1.0},\"9\":{\"tf\":1.0}}}}},\"df\":0,\"docs\":{}},\"df\":0,\"docs\":{}}},\"i\":{\"d\":{\"df\":1,\"docs\":{\"14\":{\"tf\":1.0}}},\"df\":0,\"docs\":{},\"n\":{\"c\":{\"df\":0,\"docs\":{},\"l\":{\"df\":0,\"docs\":{},\"u\":{\"d\":{\"df\":1,\"docs\":{\"4\":{\"tf\":1.0}}},\"df\":0,\"docs\":{}}}},\"df\":0,\"docs\":{},\"t\":{\"df\":0,\"docs\":{},\"r\":{\"df\":0,\"docs\":{},\"o\":{\"d\":{\"df\":0,\"docs\":{},\"u\":{\"c\":{\"df\":0,\"docs\":{},\"t\":{\"df\":1,\"docs\":{\"0\":{\"tf\":1.0}}}},\"df\":0,\"docs\":{}}},\"df\":0,\"docs\":{}}}}}},\"s\":{\"df\":0,\"docs\":{},\"e\":{\"c\":{\"df\":0,\"docs\":{},\"t\":{\"df\":0,\"docs\":{},\"i\":{\"df\":0,\"docs\":{},\"o\":{\"df\":0,\"docs\":{},\"n\":{\"df\":1,\"docs\":{\"3\":{\"tf\":1.0}}}}}}},\"df\":0,\"docs\":{}},\"n\":{\"df\":0,\"docs\":{},\"e\":{\"a\":{\"df\":0,\"docs\":{},\"k\":{\"df\":0,\"docs\":{},\"i\":{\"df\":1,\"docs\":{\"1\":{\"tf\":1.0}}}}},\"df\":0,\"docs\":{}}},\"t\":{\"df\":0,\"docs\":{},\"r\":{\"df\":0,\"docs\":{},\"e\":{\"df\":0,\"docs\":{},\"s\":{\"df\":0,\"docs\":{},\"s\":{\"df\":1,\"docs\":{\"6\":{\"tf\":1.0}}}}}}},\"u\":{\"df\":0,\"docs\":{},\"m\":{\"df\":0,\"docs\":{},\"m\":{\"a\":{\"df\":0,\"docs\":{},\"r\":{\"df\":0,\"docs\":{},\"i\":{\"df\":1,\"docs\":{\"5\":{\"tf\":1.0}}}}},\"df\":0,\"docs\":{}}}}},\"t\":{\"df\":0,\"docs\":{},\"e\":{\"df\":0,\"docs\":{},\"s\":{\"df\":0,\"docs\":{},\"t\":{\"df\":1,\"docs\":{\"6\":{\"tf\":1.0}}}},\"x\":{\"df\":0,\"docs\":{},\"t\":{\"df\":3,\"docs\":{\"10\":{\"tf\":1.0},\"11\":{\"tf\":1.0},\"9\":{\"tf\":1.0}}}}}},\"u\":{\"df\":0,\"docs\":{},\"n\":{\"df\":0,\"docs\":{},\"i\":{\"c\":{\"df\":0,\"docs\":{},\"o\":{\"d\":{\"df\":1,\"docs\":{\"6\":{\"tf\":1.0}}},\"df\":0,\"docs\":{}}},\"df\":0,\"docs\":{}}}}}}},\"lang\":\"English\",\"pipeline\":[\"trimmer\",\"stopWordFilter\",\"stemmer\"],\"ref\":\"id\",\"version\":\"0.9.5\"},\"results_options\":{\"limit_results\":30,\"teaser_word_count\":30},\"search_options\":{\"bool\":\"OR\",\"expand\":true,\"fields\":{\"body\":{\"boost\":1},\"breadcrumbs\":{\"boost\":1},\"title\":{\"boost\":2}}}}'));" }, { "path": "tests/testsuite/search/reasonable_search_index/src/SUMMARY.md", "content": "# Summary\n\n[Introduction](intro.md)\n\n- [First Chapter](first/index.md)\n - [Includes](first/includes.md)\n - [Unicode](first/unicode.md)\n - [No Headers](first/no-headers.md)\n - [Duplicate Headers](first/duplicate-headers.md)\n - [Heading Attributes](first/heading-attributes.md)\n" }, { "path": "tests/testsuite/search/reasonable_search_index/src/first/duplicate-headers.md", "content": "# Duplicate headers\n\nThis page validates behaviour of duplicate headers.\n\n# Header Text\n\n# Header Text\n\n# header-text\n" }, { "path": "tests/testsuite/search/reasonable_search_index/src/first/heading-attributes.md", "content": "# Heading Attributes {#attrs}\n\n## Heading with classes {.class1 .class2}\n\n## Heading with id and classes {#both .class1 .class2}\n" }, { "path": "tests/testsuite/search/reasonable_search_index/src/first/includes.md", "content": "# Includes\n\n{{#include ../SUMMARY.md::}}\n" }, { "path": "tests/testsuite/search/reasonable_search_index/src/first/index.md", "content": "# First Chapter\n\nmore text.\n\n## Some Section\n" }, { "path": "tests/testsuite/search/reasonable_search_index/src/first/no-headers.md", "content": "Capybara capybara capybara.\n\nCapybara capybara capybara.\n\nThisLongWordIsIncludedSoWeCanCheckThatSufficientlyLongWordsAreOmittedFromTheSearchIndex.\n" }, { "path": "tests/testsuite/search/reasonable_search_index/src/first/unicode.md", "content": "# Unicode stress tests\n\nPlease be careful editing, this contains carefully crafted characters.\n\nTwo byte character: spatiëring\n\nCombining character: spatiëring\n\nThree byte character: 书こんにちは\n\nFour byte character: 𐌀‮𐌁‮𐌂‮𐌃‮𐌄‮𐌅‮𐌆‮𐌇‮𐌈‬\n\nRight-to-left: مرحبا\n\nEmoticons: 🔊 😍 💜 1️⃣\n\nright-to-left mark: hello באמת!‏\n\n\nZalgo: ǫ̛̖̱̗̝͈̋͒͋̏ͥͫ̒̆ͩ̏͌̾͊͐ͪ̾̚\n\n" }, { "path": "tests/testsuite/search/reasonable_search_index/src/intro.md", "content": "# Introduction\n\nHere's some interesting text...\n\n## Sneaky\n\n

\n\nI put <HTML> in here!
\n

\n\n\n\nSneaky inline event .\n\nBut regular inline is indexed.\n" }, { "path": "tests/testsuite/search.rs", "content": "//! Tests for search support.\n\nuse crate::prelude::*;\nuse mdbook_core::book::{BookItem, Chapter};\nuse snapbox::file;\nuse std::path::Path;\n\nfn read_book_index(root: &Path) -> serde_json::Value {\n let index_path = glob_one(root, \"book/searchindex*.js\");\n let index = read_to_string(&index_path);\n let index =\n index.trim_start_matches(\"window.search = Object.assign(window.search, JSON.parse('\");\n let index = index.trim_end_matches(\"'));\");\n // We need unescape the string as it's supposed to be an escaped JS string.\n serde_json::from_str(&index.replace(\"\\\\'\", \"'\").replace(\"\\\\\\\\\", \"\\\\\")).unwrap()\n}\n\n// Some spot checks for the generation of the search index.\n#[test]\nfn reasonable_search_index() {\n let mut test = BookTest::from_dir(\"search/reasonable_search_index\");\n test.build();\n let index = read_book_index(&test.dir);\n\n let doc_urls = index[\"doc_urls\"].as_array().unwrap();\n eprintln!(\"doc_urls={doc_urls:#?}\",);\n let get_doc_ref = |url: &str| -> String {\n doc_urls\n .iter()\n .position(|s| s == url)\n .unwrap_or_else(|| panic!(\"failed to find {url}\"))\n .to_string()\n };\n\n let first_chapter = get_doc_ref(\"first/index.html#first-chapter\");\n let introduction = get_doc_ref(\"intro.html#introduction\");\n let some_section = get_doc_ref(\"first/index.html#some-section\");\n let summary = get_doc_ref(\"first/includes.html#summary\");\n let no_headers = get_doc_ref(\"first/no-headers.html\");\n let duplicate_headers_1 = get_doc_ref(\"first/duplicate-headers.html#header-text-1\");\n let heading_attrs = get_doc_ref(\"first/heading-attributes.html#both\");\n let sneaky = get_doc_ref(\"intro.html#sneaky\");\n\n let bodyidx = &index[\"index\"][\"index\"][\"body\"][\"root\"];\n let textidx = &bodyidx[\"t\"][\"e\"][\"x\"][\"t\"];\n assert_eq!(textidx[\"df\"], 5);\n assert_eq!(textidx[\"docs\"][&first_chapter][\"tf\"], 1.0);\n assert_eq!(textidx[\"docs\"][&introduction][\"tf\"], 1.0);\n\n let docs = &index[\"index\"][\"documentStore\"][\"docs\"];\n assert_eq!(docs[&first_chapter][\"body\"], \"more text.\");\n assert_eq!(docs[&some_section][\"body\"], \"\");\n assert_eq!(\n docs[&summary][\"body\"],\n \"Introduction First Chapter Includes Unicode No Headers Duplicate Headers Heading Attributes\"\n );\n assert_eq!(\n docs[&summary][\"breadcrumbs\"],\n \"First Chapter » Includes » Summary\"\n );\n // See note about InlineHtml in search.rs. Ideally the `alert()` part\n // should not be in the index, but we don't have a way to scrub inline\n // html.\n assert_eq!(\n docs[&sneaky][\"body\"],\n \"I put in here! Sneaky inline event . But regular inline is indexed.\"\n );\n assert_eq!(\n docs[&no_headers][\"breadcrumbs\"],\n \"First Chapter » No Headers\"\n );\n assert_eq!(\n docs[&duplicate_headers_1][\"breadcrumbs\"],\n \"First Chapter » Duplicate Headers » Header Text\"\n );\n assert_eq!(\n docs[&no_headers][\"body\"],\n \"Capybara capybara capybara. Capybara capybara capybara. ThisLongWordIsIncludedSoWeCanCheckThatSufficientlyLongWordsAreOmittedFromTheSearchIndex.\"\n );\n assert_eq!(\n docs[&heading_attrs][\"breadcrumbs\"],\n \"First Chapter » Heading Attributes » Heading with id and classes\"\n );\n}\n\n// This test is here to catch any unexpected changes to the search index.\n#[test]\nfn search_index_hasnt_changed_accidentally() {\n BookTest::from_dir(\"search/reasonable_search_index\").check_file(\n \"book/searchindex*.js\",\n file![\"search/reasonable_search_index/expected_index.js\"],\n );\n}\n\n// Ability to disable search chapters.\n#[test]\nfn can_disable_individual_chapters() {\n let mut test = BookTest::from_dir(\"search/disable_search_chapter\");\n test.build();\n let index = read_book_index(&test.dir);\n let doc_urls = index[\"doc_urls\"].as_array().unwrap();\n let contains = |path| {\n doc_urls\n .iter()\n .any(|p| p.as_str().unwrap().starts_with(path))\n };\n assert!(contains(\"second.html\"));\n assert!(!contains(\"second/\"));\n assert!(!contains(\"first/disable_me.html\"));\n assert!(contains(\"first/keep_me.html\"));\n}\n\n// Test for a regression where search would fail if source_path is None.\n// https://github.com/rust-lang/mdBook/pull/2550\n#[test]\nfn with_no_source_path() {\n let test = BookTest::from_dir(\"search/reasonable_search_index\");\n let mut book = test.load_book();\n let chapter = Chapter::new(\"Sample chapter\", String::new(), \"sample.html\", vec![]);\n book.book.items.push(BookItem::Chapter(chapter));\n book.build().unwrap();\n}\n\n// Checks that invalid settings in search chapter is rejected.\n#[test]\nfn chapter_settings_validation_error() {\n BookTest::from_dir(\"search/chapter_settings_validation_error\").run(\"build\", |cmd| {\n cmd.expect_failure().expect_stderr(str![[r#\"\n INFO Book building has started\n INFO Running the html backend\nERROR Rendering failed\n[TAB]Caused by: [output.html.search.chapter] key `does-not-exist` does not match any chapter paths\n\n\"#]]);\n });\n}\n" }, { "path": "tests/testsuite/test/failing_tests/book.toml", "content": "[book]\ntitle = \"failing_tests\"\n" }, { "path": "tests/testsuite/test/failing_tests/src/SUMMARY.md", "content": "# Summary\n\n- [Failing Tests](./failing.md)\n- [Failing Include](./failing_include.md)\n" }, { "path": "tests/testsuite/test/failing_tests/src/failing.md", "content": "# Failing Tests\n\n```rust\npanic!(\"fail\");\n```\n" }, { "path": "tests/testsuite/test/failing_tests/src/failing_include.md", "content": "# Failing Include\n\n```rust\n{{#include test1.rs:FAILING}}\n```\n" }, { "path": "tests/testsuite/test/failing_tests/src/test1.rs", "content": "fn test2() {\n println!(\"test2\");\n}\n\n// ANCHOR: PASSING\nprintln!(\"passing!\");\n// ANCHOR_END: PASSING\n\n// ANCHOR: FAILING\npanic!(\"failing!\");\n// ANCHOR_END: FAILING\n" }, { "path": "tests/testsuite/test/passing_tests/book.toml", "content": "[book]\ntitle = \"passing_tests\"\n" }, { "path": "tests/testsuite/test/passing_tests/src/SUMMARY.md", "content": "# Summary\n\n[Intro](./intro.md)\n\n- [Passing 1](./passing1.md)\n- [Passing 2](./passing2.md)\n" }, { "path": "tests/testsuite/test/passing_tests/src/passing1.md", "content": "# Passing Tests 1\n\n```rust\nassert!(true);\n```\n\n```rust\nprintln!(\"hello!\");\n```\n\n## Also check includes\n\n```rust\n{{#include test1.rs}}\n```\n\n```rust\n{{#include test2.rs:2}}\n```\n\n```rust\n{{#include test2.rs:PASSING}}\n```\n\n```rust\n{{#rustdoc_include test3.rs:2}}\n```\n\n{{#playground test1.rs}}\n" }, { "path": "tests/testsuite/test/passing_tests/src/passing2.md", "content": "# Passing Tests 2\n\n```rust\nprintln!(\"also passing\");\n```\n" }, { "path": "tests/testsuite/test/passing_tests/src/test1.rs", "content": "println!(\"test1\");\n" }, { "path": "tests/testsuite/test/passing_tests/src/test2.rs", "content": "fn test2() {\n println!(\"test2\");\n}\n\n// ANCHOR: PASSING\nprintln!(\"passing!\");\n// ANCHOR_END: PASSING\n\n// ANCHOR: FAILING\npanic!(\"failing!\");\n// ANCHOR_END: FAILING\n" }, { "path": "tests/testsuite/test/passing_tests/src/test3.rs", "content": "println!(\"test3\");\n" }, { "path": "tests/testsuite/test.rs", "content": "//! Tests for the `mdbook test` command.\n\nuse crate::prelude::*;\n\n// Simple test for passing tests.\n#[test]\nfn passing_tests() {\n BookTest::from_dir(\"test/passing_tests\").run(\"test\", |cmd| {\n cmd.expect_stdout(str![[\"\"]]).expect_stderr(str![[r#\"\n INFO Testing chapter 'Intro': \"intro.md\"\n INFO Testing chapter 'Passing 1': \"passing1.md\"\n INFO Testing chapter 'Passing 2': \"passing2.md\"\n\n\"#]]);\n });\n}\n\n// Test for a test failure\n#[test]\nfn failing_tests() {\n BookTest::from_dir(\"test/failing_tests\").run(\"test\", |cmd| {\n cmd.expect_code(101)\n .expect_stdout(str![[\"\"]])\n // This redacts a large number of lines that come from rustdoc and\n // libtest. If the output from those ever changes, then it would not\n // make it possible to test against different versions of Rust. This\n // still includes a little bit of output, so if that is a problem,\n // add more redactions.\n .expect_stderr(str![[r#\"\n INFO Testing chapter 'Failing Tests': \"failing.md\"\nERROR rustdoc returned an error:\n\n--- stdout\n\n...\ntest failing.md - Failing_Tests (line 3) ... FAILED\n...\nthread [..] panicked at failing.md:3:1:\nfail\n...\n INFO Testing chapter 'Failing Include': \"failing_include.md\"\nERROR rustdoc returned an error:\n\n--- stdout\n...\ntest failing_include.md - Failing_Include (line 3) ... FAILED\n...\nthread [..] panicked at failing_include.md:3:1:\nfailing!\n...\nERROR One or more tests failed\n\n\"#]]);\n });\n}\n\n// Test with a specific chapter.\n#[test]\nfn test_individual_chapter() {\n let mut test = BookTest::from_dir(\"test/passing_tests\");\n test.run(\"test -c\", |cmd| {\n cmd.args(&[\"Passing 1\"])\n .expect_stdout(str![[\"\"]])\n .expect_stderr(str![[r#\"\n INFO Testing chapter 'Passing 1': \"passing1.md\"\n\n\"#]]);\n })\n // Can also be a source path.\n .run(\"test -c passing2.md\", |cmd| {\n cmd.expect_stdout(str![[\"\"]]).expect_stderr(str![[r#\"\n INFO Testing chapter 'Passing 2': \"passing2.md\"\n\n\"#]]);\n });\n}\n\n// Unknown chapter name.\n#[test]\nfn chapter_not_found() {\n BookTest::from_dir(\"test/passing_tests\").run(\"test -c bogus\", |cmd| {\n cmd.expect_failure()\n .expect_stdout(str![[\"\"]])\n .expect_stderr(str![[r#\"\nERROR Chapter not found: bogus\n\n\"#]]);\n });\n}\n" }, { "path": "tests/testsuite/theme/custom_fonts_css/book.toml", "content": "[book]\ntitle = \"custom_fonts_css\"\n" }, { "path": "tests/testsuite/theme/custom_fonts_css/src/SUMMARY.md", "content": "- [Intro](index.md)\n" }, { "path": "tests/testsuite/theme/custom_fonts_css/theme/fonts/fonts.css", "content": "/*custom*/\n" }, { "path": "tests/testsuite/theme/empty_fonts_css/book.toml", "content": "[book]\ntitle = \"empty_fonts_css\"\n" }, { "path": "tests/testsuite/theme/empty_fonts_css/src/SUMMARY.md", "content": "- [Intro](index.md)\n" }, { "path": "tests/testsuite/theme/empty_fonts_css/theme/fonts/fonts.css", "content": "" }, { "path": "tests/testsuite/theme/empty_theme/book.toml", "content": "[book]\ntitle = \"empty_theme\"\n\n[output.html]\ntheme = \"./theme\"\n" }, { "path": "tests/testsuite/theme/empty_theme/src/SUMMARY.md", "content": "# Summary\n\n- [Chapter 1](./chapter_1.md)\n" }, { "path": "tests/testsuite/theme/empty_theme/src/chapter_1.md", "content": "# Chapter 1\n" }, { "path": "tests/testsuite/theme/fonts_css/src/SUMMARY.md", "content": "- [With Fonts](index.md)\n" }, { "path": "tests/testsuite/theme/fonts_css/theme/fonts/fonts.css", "content": "/*custom*/\n" }, { "path": "tests/testsuite/theme/missing_theme/book.toml", "content": "[book]\ntitle = \"missing_theme\"\n\n[output.html]\ntheme = \"./non-existent-directory\"\n" }, { "path": "tests/testsuite/theme/missing_theme/src/SUMMARY.md", "content": "# Summary\n\n- [Chapter 1](./chapter_1.md)\n" }, { "path": "tests/testsuite/theme/missing_theme/src/chapter_1.md", "content": "# Chapter 1\n" }, { "path": "tests/testsuite/theme/override_index/src/SUMMARY.md", "content": "- [Intro](index.md)\n" }, { "path": "tests/testsuite/theme/override_index/theme/index.hbs", "content": "This is a modified index.hbs!\n" }, { "path": "tests/testsuite/theme.rs", "content": "//! Tests for theme handling.\n\nuse crate::prelude::*;\n\n// Checks what happens if the theme directory is missing.\n#[test]\nfn missing_theme() {\n BookTest::from_dir(\"theme/missing_theme\").run(\"build\", |cmd| {\n cmd.expect_failure().expect_stderr(str![[r#\"\n INFO Book building has started\n INFO Running the html backend\nERROR Rendering failed\n[TAB]Caused by: theme dir [ROOT]/./non-existent-directory does not exist\n\n\"#]]);\n });\n}\n\n// Checks what happens if the theme directory is empty.\n#[test]\nfn empty_theme() {\n BookTest::from_dir(\"theme/empty_theme\").run(\"build\", |cmd| {\n std::fs::create_dir(cmd.dir.join(\"theme\")).unwrap();\n cmd.expect_stderr(str![[r#\"\n INFO Book building has started\n INFO Running the html backend\n INFO HTML book written to `[ROOT]/book`\n\n\"#]]);\n });\n}\n\n// Checks overriding index.hbs.\n#[test]\nfn override_index() {\n BookTest::from_dir(\"theme/override_index\").check_file(\n \"book/index.html\",\n str![[r#\"\nThis is a modified index.hbs!\n\n\"#]],\n );\n}\n\n// After building, what are the default set of fonts?\n#[test]\nfn default_fonts() {\n BookTest::init(|_| {})\n .check_file_contains(\"book/index.html\", \"fonts/fonts-[..].css\")\n .check_file_list(\n \"book/fonts\",\n str![[r#\"\nbook/fonts/OPEN-SANS-LICENSE.txt\nbook/fonts/SOURCE-CODE-PRO-LICENSE.txt\nbook/fonts/fonts-[..].css\nbook/fonts/open-sans-v17-all-charsets-300-[..].woff2\nbook/fonts/open-sans-v17-all-charsets-300italic-[..].woff2\nbook/fonts/open-sans-v17-all-charsets-600-[..].woff2\nbook/fonts/open-sans-v17-all-charsets-600italic-[..].woff2\nbook/fonts/open-sans-v17-all-charsets-700-[..].woff2\nbook/fonts/open-sans-v17-all-charsets-700italic-[..].woff2\nbook/fonts/open-sans-v17-all-charsets-800-[..].woff2\nbook/fonts/open-sans-v17-all-charsets-800italic-[..].woff2\nbook/fonts/open-sans-v17-all-charsets-italic-[..].woff2\nbook/fonts/open-sans-v17-all-charsets-regular-[..].woff2\nbook/fonts/source-code-pro-v11-all-charsets-500-[..].woff2\n\"#]],\n );\n}\n\n// When the theme is initialized, what does the fonts list look like?\n#[test]\nfn theme_fonts_copied() {\n BookTest::init(|bb| {\n bb.copy_theme(true);\n })\n .check_file_contains(\"book/index.html\", \"fonts/fonts-[..].css\")\n .check_file_list(\n \"theme/fonts\",\n str![[r#\"\ntheme/fonts/OPEN-SANS-LICENSE.txt\ntheme/fonts/SOURCE-CODE-PRO-LICENSE.txt\ntheme/fonts/fonts.css\ntheme/fonts/open-sans-v17-all-charsets-300.woff2\ntheme/fonts/open-sans-v17-all-charsets-300italic.woff2\ntheme/fonts/open-sans-v17-all-charsets-600.woff2\ntheme/fonts/open-sans-v17-all-charsets-600italic.woff2\ntheme/fonts/open-sans-v17-all-charsets-700.woff2\ntheme/fonts/open-sans-v17-all-charsets-700italic.woff2\ntheme/fonts/open-sans-v17-all-charsets-800.woff2\ntheme/fonts/open-sans-v17-all-charsets-800italic.woff2\ntheme/fonts/open-sans-v17-all-charsets-italic.woff2\ntheme/fonts/open-sans-v17-all-charsets-regular.woff2\ntheme/fonts/source-code-pro-v11-all-charsets-500.woff2\n\"#]],\n )\n // Note that license files get hashed, which is not like the behavior when\n // the theme directory is empty. It kinda makes sense, but is weird.\n .check_file_list(\n \"book/fonts\",\n str![[r#\"\nbook/fonts/OPEN-SANS-LICENSE-[..].txt\nbook/fonts/SOURCE-CODE-PRO-LICENSE-[..].txt\nbook/fonts/fonts-[..].css\nbook/fonts/open-sans-v17-all-charsets-300-[..].woff2\nbook/fonts/open-sans-v17-all-charsets-300italic-[..].woff2\nbook/fonts/open-sans-v17-all-charsets-600-[..].woff2\nbook/fonts/open-sans-v17-all-charsets-600italic-[..].woff2\nbook/fonts/open-sans-v17-all-charsets-700-[..].woff2\nbook/fonts/open-sans-v17-all-charsets-700italic-[..].woff2\nbook/fonts/open-sans-v17-all-charsets-800-[..].woff2\nbook/fonts/open-sans-v17-all-charsets-800italic-[..].woff2\nbook/fonts/open-sans-v17-all-charsets-italic-[..].woff2\nbook/fonts/open-sans-v17-all-charsets-regular-[..].woff2\nbook/fonts/source-code-pro-v11-all-charsets-500-[..].woff2\n\"#]],\n );\n}\n\n// Custom fonts.css.\n#[test]\nfn fonts_css() {\n BookTest::from_dir(\"theme/fonts_css\")\n .check_file_contains(\"book/index.html\", \"fonts/fonts-[..].css\")\n .check_file(\n \"book/fonts/fonts-*.css\",\n str![[r#\"\n/*custom*/\n\n\"#]],\n )\n .check_file(\"book/fonts/myfont-*.woff\", str![[\"\"]])\n .check_file_list(\n \"book/fonts\",\n str![[r#\"\nbook/fonts/fonts-[..].css\nbook/fonts/myfont-[..].woff\n\"#]],\n );\n}\n\n// Empty fonts.css should not copy the default fonts.\n#[test]\nfn empty_fonts_css() {\n BookTest::from_dir(\"theme/empty_fonts_css\")\n .run(\"build\", |cmd| {\n cmd.expect_stderr(str![[r#\"\n INFO Book building has started\n INFO Running the html backend\n INFO HTML book written to `[ROOT]/book`\n\n\"#]]);\n })\n .check_file_contains(\"book/index.html\", \"fonts.css\")\n .check_file_list(\"book/fonts\", str![[\"\"]]);\n}\n\n// Custom fonts.css file shouldn't copy default fonts.\n#[test]\nfn custom_fonts_css() {\n BookTest::from_dir(\"theme/custom_fonts_css\")\n .run(\"build\", |cmd| {\n cmd.expect_stderr(str![[r#\"\n INFO Book building has started\n INFO Running the html backend\n INFO HTML book written to `[ROOT]/book`\n\n\"#]]);\n })\n .check_file_contains(\"book/index.html\", \"fonts-[..].css\")\n .check_file_list(\n \"book/fonts\",\n str![[r#\"\nbook/fonts/fonts-[..].css\nbook/fonts/myfont-[..].woff\n\"#]],\n );\n}\n" }, { "path": "tests/testsuite/toc/basic_toc/book.toml", "content": "[book]\ntitle = \"basic_toc\"\n" }, { "path": "tests/testsuite/toc/basic_toc/src/README.md", "content": "# With Readme\n" }, { "path": "tests/testsuite/toc/basic_toc/src/SUMMARY.md", "content": "# Summary\n\n[Prefix 1](prefix1.md)\n[Prefix 2](prefix2.md)\n\n- [With Readme](README.md)\n - [Nested Index](nested/index.md)\n - [Nested two](nested/two.md)\n- [Draft]()\n\n---\n\n# Deep Nest\n\n- [Deep Nest 1](deep/index.md)\n - [Deep Nest 2](deep/a/index.md)\n - [Deep Nest 3](deep/a/b/index.md)\n [Deep Nest 4](deep/a/b/c/index.md)\n\n---\n\n[Suffix 1](suffix1.md)\n[Suffix 2](suffix2.md)\n" }, { "path": "tests/testsuite/toc/basic_toc/src/deep/a/b/index.md", "content": "# Deep Nest 3\n" }, { "path": "tests/testsuite/toc/basic_toc/src/deep/a/index.md", "content": "# Deep Nest 2\n" }, { "path": "tests/testsuite/toc/basic_toc/src/deep/index.md", "content": "# Deep Nest 1\n" }, { "path": "tests/testsuite/toc/basic_toc/src/nested/index.md", "content": "# Nested Index\n" }, { "path": "tests/testsuite/toc/basic_toc/src/nested/two.md", "content": "# Nested two\n" }, { "path": "tests/testsuite/toc/basic_toc/src/prefix1.md", "content": "# Prefix 1\n" }, { "path": "tests/testsuite/toc/basic_toc/src/prefix2.md", "content": "# Prefix 2\n" }, { "path": "tests/testsuite/toc/basic_toc/src/suffix1.md", "content": "# Suffix 1\n" }, { "path": "tests/testsuite/toc/basic_toc/src/suffix2.md", "content": "# Suffix 2\n" }, { "path": "tests/testsuite/toc/summary_with_markdown_formatting/src/SUMMARY.md", "content": "# Summary formatting tests\n\n- [*Italic* `code` \\*escape\\* \\`escape2\\`](formatted-summary.md)\n- [Soft\nline break](soft.md)\n- [\\](escaped-tag.md)\n" }, { "path": "tests/testsuite/toc.rs", "content": "//! Tests for table of contents (sidebar).\n\nuse crate::prelude::*;\nuse anyhow::Result;\nuse select::document::Document;\nuse select::predicate::{Attr, Class, Name, Predicate};\n\nconst TOC_TOP_LEVEL: &[&str] = &[\n \"1. With Readme\",\n \"3. Deep Nest 1\",\n \"Prefix 1\",\n \"Prefix 2\",\n \"Suffix 1\",\n \"Suffix 2\",\n];\nconst TOC_SECOND_LEVEL: &[&str] = &[\n \"1.1. Nested Index\",\n \"1.2. Nested two\",\n \"3.1. Deep Nest 2\",\n \"3.1.1. Deep Nest 3\",\n];\n\n/// Apply a series of predicates to some root predicate, where each\n/// successive predicate is the descendant of the last one. Similar to how you\n/// might do `ul.foo li a` in CSS to access all anchor tags in the `foo` list.\nmacro_rules! descendants {\n ($root:expr, $($child:expr),*) => {\n $root\n $(\n .descendant($child)\n )*\n };\n}\n\n/// Read the TOC (`book/toc.js`) nested HTML and expose it as a DOM which we\n/// can search with the `select` crate\nfn toc_js_html() -> Document {\n let mut test = BookTest::from_dir(\"toc/basic_toc\");\n test.build();\n let html = test.toc_js_html();\n Document::from(html.as_str())\n}\n\n/// Read the TOC fallback (`book/toc.html`) HTML and expose it as a DOM which we\n/// can search with the `select` crate\nfn toc_fallback_html() -> Result {\n let mut test = BookTest::from_dir(\"toc/basic_toc\");\n test.build();\n\n let toc_path = test.dir.join(\"book\").join(\"toc.html\");\n let html = read_to_string(toc_path);\n Ok(Document::from(html.as_str()))\n}\n\n#[test]\nfn check_second_toc_level() {\n let doc = toc_js_html();\n let mut should_be = Vec::from(TOC_SECOND_LEVEL);\n should_be.sort_unstable();\n\n let pred = descendants!(\n Class(\"chapter\"),\n Name(\"li\"),\n Name(\"li\"),\n Name(\"a\").and(Class(\"toggle\").not())\n );\n\n let mut children_of_children: Vec<_> = doc\n .find(pred)\n .map(|elem| elem.text().trim().to_string())\n .collect();\n children_of_children.sort();\n\n assert_eq!(children_of_children, should_be);\n}\n\n#[test]\nfn check_first_toc_level() {\n let doc = toc_js_html();\n let mut should_be = Vec::from(TOC_TOP_LEVEL);\n\n should_be.extend(TOC_SECOND_LEVEL);\n should_be.sort_unstable();\n\n let pred = descendants!(\n Class(\"chapter\"),\n Name(\"li\"),\n Name(\"a\").and(Class(\"toggle\").not())\n );\n\n let mut children: Vec<_> = doc\n .find(pred)\n .map(|elem| elem.text().trim().to_string())\n .collect();\n children.sort();\n\n assert_eq!(children, should_be);\n}\n\n#[test]\nfn check_spacers() {\n let doc = toc_js_html();\n let should_be = 2;\n\n let num_spacers = doc\n .find(Class(\"chapter\").descendant(Name(\"li\").and(Class(\"spacer\"))))\n .count();\n assert_eq!(num_spacers, should_be);\n}\n\n// don't use target=\"_parent\" in JS\n#[test]\nfn check_link_target_js() {\n let doc = toc_js_html();\n\n let num_parent_links = doc\n .find(\n Class(\"chapter\")\n .descendant(Name(\"li\"))\n .descendant(Name(\"a\").and(Attr(\"target\", \"_parent\"))),\n )\n .count();\n assert_eq!(num_parent_links, 0);\n}\n\n// don't use target=\"_parent\" in IFRAME\n#[test]\nfn check_link_target_fallback() {\n let doc = toc_fallback_html().unwrap();\n\n let num_parent_links = doc\n .find(\n Class(\"chapter\")\n .descendant(Name(\"li\"))\n .descendant(Name(\"a\").and(Attr(\"target\", \"_parent\"))),\n )\n .count();\n assert_eq!(\n num_parent_links,\n TOC_TOP_LEVEL.len() + TOC_SECOND_LEVEL.len()\n );\n}\n\n// Checks formatting of summary names with inline elements.\n#[test]\nfn summary_with_markdown_formatting() {\n BookTest::from_dir(\"toc/summary_with_markdown_formatting\")\n .check_toc_js(str![[r#\"\n
    \n
  1. \n\n\n1. Italic code *escape* `escape2`\n\n
    2. \n
  2. \n\n\n2. Soft line break\n\n
    3. \n
  3. \n\n\n3. <escaped tag>\n\n
    4. \n
\n\"#]])\n .check_file(\n \"src/formatted-summary.md\",\n str![[r#\"\n# Italic code *escape* `escape2`\n\n\"#]],\n )\n .check_file(\n \"src/soft.md\",\n str![[r#\"\n# Soft line break\n\n\"#]],\n )\n .check_file(\n \"src/escaped-tag.md\",\n str![[r#\"\n# <escaped tag>\n\n\"#]],\n );\n}\n" }, { "path": "triagebot.toml", "content": "# This will allow users to self assign, and/or drop assignment\n[assign]\n\n# Allows @rustbot ready, review, author, or blocked\n[shortcut]\n\n# Closes/reopens PRs created by the GitHub Actions bot so that checks will run.\n[bot-pull-requests]\n\n# When rebasing, this will add a diff link in a comment.\n[range-diff]\n\n[relabel]\nallow-unauthenticated = [\n # For Issue areas\n \"A-*\",\n # Categories\n \"C-*\",\n # Commands\n \"Command-*\",\n # Status\n \"S-*\",\n \"regression\",\n \"Breaking Change\",\n \"msrv-bump\",\n]\n\n[autolabel.\"S-waiting-on-review\"]\nnew_pr = true\n\n[merge-conflicts]\nremove = []\nadd = [\"S-waiting-on-author\"]\nunless = [\"S-blocked\", \"S-waiting-on-review\"]\n\n[review-submitted]\nreviewed_label = \"S-waiting-on-author\"\nreview_labels = [\"S-waiting-on-review\"]\n\n[review-requested]\nremove_labels = [\"S-waiting-on-author\"]\nadd_labels = [\"S-waiting-on-review\"]\n" } ]