├── .editorconfig ├── .github └── workflows │ ├── build.yml │ ├── release.yml │ └── website.yml ├── .gitignore ├── .release-please-manifest.json ├── CHANGELOG.md ├── LICENSE ├── README.md ├── assets ├── catwalk.webp ├── frappe.webp ├── latte.webp ├── macchiato.webp └── mocha.webp ├── example ├── .gitignore ├── book.toml ├── src │ ├── SUMMARY.md │ ├── admonish.md │ ├── alerts.md │ ├── landing.md │ └── secret.md └── theme │ ├── catppuccin-admonish.css │ ├── catppuccin-alerts.css │ ├── catppuccin.css │ ├── index.hbs │ └── mdbook-admonish.css ├── package.json ├── pnpm-lock.yaml ├── release-please-config.json ├── renovate.json └── src ├── catppuccin-admonish.scss ├── catppuccin-alerts.scss └── catppuccin.scss /.editorconfig: -------------------------------------------------------------------------------- 1 | # EditorConfig helps developers define and maintain consistent 2 | # coding styles between different editors and IDEs 3 | # EditorConfig is awesome: https://EditorConfig.org 4 | 5 | root = true 6 | 7 | [*] 8 | charset = utf-8 9 | indent_size = 2 10 | indent_style = space 11 | end_of_line = lf 12 | insert_final_newline = true 13 | trim_trailing_whitespace = true 14 | 15 | # go 16 | [*.go] 17 | indent_style = tab 18 | indent_size = 4 19 | 20 | # python 21 | [*.{ini,py,py.tpl,rst}] 22 | indent_size = 4 23 | 24 | # rust 25 | [*.rs] 26 | indent_size = 4 27 | 28 | # documentation, utils 29 | [*.{md,mdx,diff}] 30 | trim_trailing_whitespace = false 31 | 32 | # windows shell scripts 33 | [*.{cmd,bat,ps1}] 34 | end_of_line = crlf 35 | -------------------------------------------------------------------------------- /.github/workflows/build.yml: -------------------------------------------------------------------------------- 1 | name: build 2 | 3 | on: 4 | workflow_dispatch: 5 | push: 6 | branches: ["main"] 7 | pull_request: 8 | 9 | jobs: 10 | build: 11 | runs-on: ubuntu-latest 12 | steps: 13 | - name: Checkout Repository 14 | uses: actions/checkout@v4 15 | - name: Setup PNPM 16 | uses: pnpm/action-setup@v4 17 | - name: Setup Node 18 | uses: actions/setup-node@v4 19 | with: 20 | node-version: "lts/*" 21 | cache: "pnpm" 22 | - name: Install dependencies 23 | run: pnpm install 24 | - name: Build 25 | run: pnpm build 26 | - name: Upload CSS 27 | uses: actions/upload-artifact@v4 28 | with: 29 | name: "catppuccin-mdbook-css-files" 30 | path: dist/ 31 | -------------------------------------------------------------------------------- /.github/workflows/release.yml: -------------------------------------------------------------------------------- 1 | name: release 2 | 3 | on: 4 | workflow_dispatch: 5 | push: 6 | branches: 7 | - main 8 | 9 | permissions: 10 | contents: write 11 | pull-requests: write 12 | 13 | jobs: 14 | release-please: 15 | runs-on: ubuntu-latest 16 | outputs: 17 | release_created: ${{ steps.release.outputs.release_created }} 18 | tag_name: ${{ steps.release.outputs.tag_name }} 19 | steps: 20 | - uses: googleapis/release-please-action@v4 21 | id: release 22 | 23 | build: 24 | needs: ["release-please"] 25 | if: needs.release-please.outputs.release_created 26 | runs-on: ubuntu-latest 27 | steps: 28 | - name: Checkout Repository 29 | uses: actions/checkout@v4 30 | - name: Setup PNPM 31 | uses: pnpm/action-setup@v4 32 | - name: Setup Node 33 | uses: actions/setup-node@v4 34 | with: 35 | node-version: "lts/*" 36 | cache: "pnpm" 37 | - name: Install dependencies 38 | run: pnpm install 39 | - name: Build 40 | run: pnpm build 41 | - name: Upload Artifacts to Release 42 | run: gh release upload ${{ needs.release-please.outputs.tag_name }} dist/*.css 43 | env: 44 | GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} 45 | -------------------------------------------------------------------------------- /.github/workflows/website.yml: -------------------------------------------------------------------------------- 1 | name: website 2 | 3 | on: 4 | workflow_dispatch: 5 | push: 6 | branches: ["main"] 7 | 8 | jobs: 9 | website: 10 | runs-on: ubuntu-latest 11 | permissions: 12 | id-token: write 13 | pages: write 14 | environment: 15 | name: github-pages 16 | url: ${{ steps.deploy.outputs.page_url }} 17 | steps: 18 | - name: Checkout repository 19 | uses: actions/checkout@v4 20 | - name: Setup mdBook 21 | uses: peaceiris/actions-mdbook@v2 22 | with: 23 | mdbook-version: "0.4.47" 24 | - name: Download mdbook-admonish 25 | run: | 26 | mkdir ${{ env.TARGET }} 27 | curl -sSL https://github.com/tommilligan/mdbook-admonish/releases/download/${{ env.VERSION }}/${{ env.TARGET }}.tar.gz | tar -xz --directory=${{ env.TARGET }} 28 | echo `pwd`/${{ env.TARGET }} >> $GITHUB_PATH 29 | env: 30 | VERSION: "v1.19.0" 31 | TARGET: "mdbook-admonish-v1.19.0-x86_64-unknown-linux-gnu" 32 | - name: Download mdbook-alerts 33 | run: | 34 | mkdir ${{ env.TARGET }} 35 | curl -sSLo ${{ env.TARGET }}/${{ env.BINARY }} https://github.com/lambdalisue/rs-mdbook-alerts/releases/download/${{ env.VERSION }}/${{ env.TARGET }} 36 | chmod +x ${{ env.TARGET }}/${{ env.BINARY }} 37 | echo `pwd`/${{ env.TARGET }} >> $GITHUB_PATH 38 | env: 39 | VERSION: "v0.6.9" 40 | BINARY: "mdbook-alerts" 41 | TARGET: "mdbook-alerts-x86_64-unknown-linux-gnu" 42 | - name: Setup PNPM 43 | uses: pnpm/action-setup@v4 44 | - name: Setup Node 45 | uses: actions/setup-node@v4 46 | with: 47 | node-version: "lts/*" 48 | cache: "pnpm" 49 | - name: Install dependencies 50 | run: pnpm install 51 | - name: Build 52 | run: pnpm build 53 | - name: Build mdBook 54 | run: | 55 | mdbook build 56 | working-directory: ./example 57 | - name: Upload artifact 58 | uses: actions/upload-pages-artifact@v3 59 | with: 60 | path: "./example/book/" 61 | - name: Deploy artifact to GitHub Pages 62 | id: deploy 63 | uses: actions/deploy-pages@v4 64 | -------------------------------------------------------------------------------- /.gitignore: -------------------------------------------------------------------------------- 1 | # node 2 | node_modules/ 3 | dist/ 4 | 5 | # ide 6 | .vscode 7 | .idea -------------------------------------------------------------------------------- /.release-please-manifest.json: -------------------------------------------------------------------------------- 1 | {".":"3.1.1"} 2 | -------------------------------------------------------------------------------- /CHANGELOG.md: -------------------------------------------------------------------------------- 1 | # CHANGELOG 2 | 3 | ## [3.1.1](https://github.com/catppuccin/mdBook/compare/v3.1.0...v3.1.1) (2025-03-24) 4 | 5 | 6 | ### Bug Fixes 7 | 8 | * theme clipboard copy button ([#154](https://github.com/catppuccin/mdBook/issues/154)) ([92eb828](https://github.com/catppuccin/mdBook/commit/92eb82828fc7077ae4860fadd277e58134fbd602)) 9 | 10 | 11 | ### Build system & distribution 12 | 13 | * **example:** update mdbook & mdbook-admonish ([#156](https://github.com/catppuccin/mdBook/issues/156)) ([ce6d873](https://github.com/catppuccin/mdBook/commit/ce6d8737732fda8a1856874afe7abb81ba42e262)) 14 | 15 | ## [3.1.0](https://github.com/catppuccin/mdBook/compare/v3.0.3...v3.1.0) (2024-11-15) 16 | 17 | 18 | ### Features 19 | 20 | * add support for `lambdalisue/rs-mdbook-alerts` ([#135](https://github.com/catppuccin/mdBook/issues/135)) ([cd3ca47](https://github.com/catppuccin/mdBook/commit/cd3ca47e761df31288641a5134879b8e76af827f)) 21 | 22 | 23 | ### Bug Fixes 24 | 25 | * change inline codeblocks from `peach` to `text` ([45da623](https://github.com/catppuccin/mdBook/commit/45da62372ca500102ec542cebc39ec999f196ff2)) 26 | * increase contrast on icons hover ([#140](https://github.com/catppuccin/mdBook/issues/140)) ([7edf128](https://github.com/catppuccin/mdBook/commit/7edf128b50f9a256d3a0ec37defad3ff755369fa)) 27 | * preserve links as `blue` inside inline codeblocks ([45da623](https://github.com/catppuccin/mdBook/commit/45da62372ca500102ec542cebc39ec999f196ff2)) 28 | 29 | 30 | ### Code Refactoring 31 | 32 | * consistently use "flavor" and "color" spellings, update sass syntax ([#138](https://github.com/catppuccin/mdBook/issues/138)) ([fa0912e](https://github.com/catppuccin/mdBook/commit/fa0912e7eea8863278d566e33b2dd45d9625fd40)) 33 | * **website:** set default to `latte` ([#141](https://github.com/catppuccin/mdBook/issues/141)) ([e8a0135](https://github.com/catppuccin/mdBook/commit/e8a013513c882e390f2694f74cede5da76a5cf83)) 34 | 35 | ## [3.0.3](https://github.com/catppuccin/mdBook/compare/v3.0.2...v3.0.3) (2024-09-22) 36 | 37 | 38 | ### Bug Fixes 39 | 40 | * highlightjs syntax highlighting ([#119](https://github.com/catppuccin/mdBook/issues/119)) ([5a04755](https://github.com/catppuccin/mdBook/commit/5a04755004cf75aff86f911e684b915c9505f76f)) 41 | * properly theme `hr` element ([#122](https://github.com/catppuccin/mdBook/issues/122)) ([90d4392](https://github.com/catppuccin/mdBook/commit/90d4392a45244cde7f0c846c5c75cfa91e0349ea)) 42 | * reduce harshness of hover highlight ([ac84329](https://github.com/catppuccin/mdBook/commit/ac84329f1e251055f007a93cdff4caab732680fb)) 43 | * theme tooltip when copying from codeblock ([ac84329](https://github.com/catppuccin/mdBook/commit/ac84329f1e251055f007a93cdff4caab732680fb)) 44 | 45 | ## [3.0.2](https://github.com/catppuccin/mdBook/compare/v3.0.1...v3.0.2) (2024-09-22) 46 | 47 | 48 | ### Code Refactoring 49 | 50 | * add symlinks back ([0aad6a2](https://github.com/catppuccin/mdBook/commit/0aad6a2f148faf7f8d112a53c0529f8a80a4de80)) 51 | * **example:** remove symlinks to see if website ci passes ([291ceb7](https://github.com/catppuccin/mdBook/commit/291ceb76911b0656544c1e4b4e0cdf6322a52835)) 52 | * **example:** update mdbook-admonish & rework pages ci ([#116](https://github.com/catppuccin/mdBook/issues/116)) ([db0d22c](https://github.com/catppuccin/mdBook/commit/db0d22cc63d4d24cd23c6635de1ab55ef2f1d499)) 53 | * ignore css in example directory ([ccc7de7](https://github.com/catppuccin/mdBook/commit/ccc7de7d6c1fbb2a64da6d4cf516d30524b40afa)) 54 | * switch borders from `crust` to `surface0` ([#118](https://github.com/catppuccin/mdBook/issues/118)) ([c315046](https://github.com/catppuccin/mdBook/commit/c3150466e94cdd08e1bea5b92c18d0a7ecb84f28)) 55 | 56 | ## [3.0.1](https://github.com/catppuccin/mdBook/compare/v3.0.0...v3.0.1) (2024-09-22) 57 | 58 | 59 | ### Code Refactoring 60 | 61 | * remove all rust ([#114](https://github.com/catppuccin/mdBook/issues/114)) ([e1da91c](https://github.com/catppuccin/mdBook/commit/e1da91c95e99cf5642a4aff020865a8ffa7ca481)) 62 | 63 | ## [3.0.0](https://github.com/catppuccin/mdBook/compare/v2.2.0...v3.0.0) (2024-09-22) 64 | 65 | 66 | ### ⚠ BREAKING CHANGES 67 | 68 | * deprecate rust plugin & update sass files ([#112](https://github.com/catppuccin/mdBook/issues/112)) 69 | 70 | ### Features 71 | 72 | * deprecate rust plugin & update sass files ([#112](https://github.com/catppuccin/mdBook/issues/112)) ([f705cb5](https://github.com/catppuccin/mdBook/commit/f705cb5a0ca7932ea88480b1793b915f47b52146)) 73 | 74 | ## [2.2.0](https://github.com/catppuccin/mdBook/compare/v2.1.0...v2.2.0) (2024-08-15) 75 | 76 | 77 | ### Features 78 | 79 | * add deprecation notice ([#109](https://github.com/catppuccin/mdBook/issues/109)) ([d023fd5](https://github.com/catppuccin/mdBook/commit/d023fd52c6d31fe6236339afe1fd73d76d7f83e9)) 80 | 81 | 82 | ### Build system & distribution 83 | 84 | * don't make draft releases ([#110](https://github.com/catppuccin/mdBook/issues/110)) ([80fefcd](https://github.com/catppuccin/mdBook/commit/80fefcd3e51bf41ae1de3803e0963afb8d4b0b58)) 85 | * **nix:** fix darwin devShell ([#94](https://github.com/catppuccin/mdBook/issues/94)) ([218116e](https://github.com/catppuccin/mdBook/commit/218116e83688f2786af71eef5d11108f71950987)) 86 | 87 | ## [2.1.0](https://github.com/catppuccin/mdBook/compare/v2.0.1...v2.1.0) (2023-11-11) 88 | 89 | 90 | ### Features 91 | 92 | * **cli:** add shell completion ([a9a79c6](https://github.com/catppuccin/mdBook/commit/a9a79c6f5441f1f62ae4658d7d1aaf9f79b3b9d3)) 93 | * style `.warning` class ([#91](https://github.com/catppuccin/mdBook/issues/91)) ([ff9851d](https://github.com/catppuccin/mdBook/commit/ff9851d395934d8b5a084b7290d992b127169d51)) 94 | 95 | 96 | ### Build system & distribution 97 | 98 | * **cargo:** reduce build-time dependencies ([8e9ea6e](https://github.com/catppuccin/mdBook/commit/8e9ea6e2e9fd7b33fb62740eca4d7fb47aa3b38e)) 99 | * **cargo:** update/unpin clap and mdbook ([b209ae7](https://github.com/catppuccin/mdBook/commit/b209ae7ffa85e5cc3dba1dbf5e73b2560ad592c7)) 100 | * **distribution:** remove `linux-musl`, `win-gnu`, and `win32-msvc` ([170419d](https://github.com/catppuccin/mdBook/commit/170419dd6059a164b46ef60b85d9fc153603eb53)) 101 | * **nix:** add shell completions ([#89](https://github.com/catppuccin/mdBook/issues/89)) ([097a72a](https://github.com/catppuccin/mdBook/commit/097a72ab17272063772f88441c902511f36bd188)) 102 | * **nix:** drop macOS native dependencies ([#88](https://github.com/catppuccin/mdBook/issues/88)) ([547ed85](https://github.com/catppuccin/mdBook/commit/547ed8546b1870cb1e5747a2f2338aa33b3af522)) 103 | * **website:** use mdbook-admonish v1.13.0 ([33eb09c](https://github.com/catppuccin/mdBook/commit/33eb09c677719474e8726e6bf7278e1c9390cacc)) 104 | 105 | ## [2.0.1](https://github.com/catppuccin/mdBook/compare/v2.0.0...v2.0.1) (2023-10-09) 106 | 107 | 108 | ### Bug Fixes 109 | 110 | * **admonish:** prefix `admonish-` to class names ([#76](https://github.com/catppuccin/mdBook/issues/76)) ([ba711b6](https://github.com/catppuccin/mdBook/commit/ba711b6ceb67f9d4e352cafc4a11d8a28d0b4980)) 111 | 112 | ## [2.0.0](https://github.com/catppuccin/mdBook/compare/v1.2.0...v2.0.0) (2023-10-07) 113 | 114 | 115 | ### ⚠ BREAKING CHANGES 116 | 117 | * support mdbook version `0.4.35` 118 | 119 | ### Features 120 | 121 | * **cli:** add "--force" flag to install command ([28f9d0f](https://github.com/catppuccin/mdBook/commit/28f9d0f02aea41c7278659fb22ba9db5bbf02b5d)) 122 | * **cli:** detect differences in major version ([8956c61](https://github.com/catppuccin/mdBook/commit/8956c61a727b0408be202c9c7fc6c2f336166272)) 123 | * support mdbook version `0.4.35` ([55e8722](https://github.com/catppuccin/mdBook/commit/55e872267de2c63e91659c6be5eac1be4fc34540)) 124 | 125 | ## [1.2.0](https://github.com/catppuccin/mdBook/compare/v1.1.0...v1.2.0) (2023-10-03) 126 | 127 | 128 | ### Features 129 | 130 | * darken struckout text ([5388763](https://github.com/catppuccin/mdBook/commit/5388763d108a72e1f0bd99656d7c88439fe9243a)) 131 | * switch to clap v4 ([a1ddb9a](https://github.com/catppuccin/mdBook/commit/a1ddb9a11b6a5e83b75dbfeebe776ad7658ac9eb)) 132 | 133 | 134 | ### Bug Fixes 135 | 136 | * clap typecasting panic ([1193c91](https://github.com/catppuccin/mdBook/commit/1193c91b092da7f7496fb78431045733814789f0)) 137 | * colours in `diff` codeblock ([#67](https://github.com/catppuccin/mdBook/issues/67)) ([a3b3f77](https://github.com/catppuccin/mdBook/commit/a3b3f7726c85cc815279f62fbd096d7249429866)) 138 | 139 | ## [1.1.0](https://github.com/catppuccin/mdBook/compare/v1.0.0...v1.1.0) (2023-10-02) 140 | 141 | 142 | ### Features 143 | 144 | * darken struckout text ([5388763](https://github.com/catppuccin/mdBook/commit/5388763d108a72e1f0bd99656d7c88439fe9243a)) 145 | * switch to clap v4 ([a1ddb9a](https://github.com/catppuccin/mdBook/commit/a1ddb9a11b6a5e83b75dbfeebe776ad7658ac9eb)) 146 | 147 | 148 | ### Bug Fixes 149 | 150 | * colours in `diff` codeblock ([#67](https://github.com/catppuccin/mdBook/issues/67)) ([a3b3f77](https://github.com/catppuccin/mdBook/commit/a3b3f7726c85cc815279f62fbd096d7249429866)) 151 | 152 | ## [1.0.0](https://github.com/catppuccin/mdBook/compare/mdbook-catppuccin-v0.2.1...mdbook-catppuccin-v1.0.0) (2023-09-17) 153 | 154 | 155 | ### ⚠ BREAKING CHANGES 156 | 157 | * merge css files and separate admonish 158 | 159 | ### Features 160 | 161 | * add mdbook-admonish support ([#59](https://github.com/catppuccin/mdBook/issues/59)) ([c8ba6ec](https://github.com/catppuccin/mdBook/commit/c8ba6ec236ba0bf7f4579dd8d31f27d454d7d61c)) 162 | * style nested `blockquote` and `hr` ([f78383c](https://github.com/catppuccin/mdBook/commit/f78383ce5bedd6b276d6f12656f35f2474de91fe)) 163 | 164 | ### Code Refactoring 165 | 166 | * merge css files and separate admonish ([5a160cd](https://github.com/catppuccin/mdBook/commit/5a160cd7e9a8ba21fc4cb4c884e3a664fcf715ea)) 167 | 168 | ## [v0.2.1](https://github.com/catppuccin/mdBook/releases/tag/v0.2.1) - 2023-07-29 169 | 170 | ### Bug Fixes 171 | 172 | * add `cargo` feature for `crate_version` by @sgoudham (dde0c18b73f8742f0e5ef29629d1107552b7bab1) 173 | * This fixes #52 174 | * pin mdbook to 0.4.22 by @nyxkrage (cc92a344d1693d6f0a54fc55110af57bb2dfe70a) 175 | * This will prevent issues like #52 from happening again. 176 | * Fix source filter in `flake.nix` by @VojtechStep in https://github.com/catppuccin/mdBook/pull/51 177 | 178 | ## [v0.2.0](https://github.com/catppuccin/mdBook/releases/tag/v0.2.0) - 2023-06-16 02:13:13 179 | 180 | Apologies for leaving this on the backburner for so long! 181 | 182 | This release makes the port more maintainable as we are now using [catppuccin/highlightjs](https://github.com/catppuccin/highlightjs) for the majority of the CSS. 183 | There has also been improvements to the CI/CD pipeline and includes a Nix flake (which I still need to fix!) 184 | 185 | Thanks to anyone who chooses to use this, I really appreciate it <3 186 | 187 | ### Feature 188 | 189 | - general: 190 | - use npm package imports, update highlightjs ([f3bcc7e](https://github.com/catppuccin/mdBook/commit/f3bcc7e601fb1850d120c12e961cf8d4fb3883ed)) ([#39](https://github.com/catppuccin/mdBook/pull/39)) 191 | - dependabot is over party ([07a4d8a](https://github.com/catppuccin/mdBook/commit/07a4d8a06c6ec4b65e0ed6702bf61849acc9e073)) ([#16](https://github.com/catppuccin/mdBook/pull/16)) 192 | 193 | ### Bug Fixes 194 | 195 | - general: 196 | - different colours for code blocks and inline code ([87a1749](https://github.com/catppuccin/mdBook/commit/87a1749fdf8d6046aa986fe5199fea74bd5299e1)) 197 | - code backgrounds updated to `mantle` ([5feb4df](https://github.com/catppuccin/mdBook/commit/5feb4df45897b9399351588e230960ec9cdeefda)) ([#45](https://github.com/catppuccin/mdBook/pull/45)) 198 | - update to fixed highlightjs version ([98cf81a](https://github.com/catppuccin/mdBook/commit/98cf81a998a49c3176854f46c6e9a971f34b1c93)) ([#39](https://github.com/catppuccin/mdBook/pull/39)) 199 | - move output from `/bin/assets` to `/src/bin/assets` ([759ad4f](https://github.com/catppuccin/mdBook/commit/759ad4fe0e7e575214115a4eb0f64b32f9b294e8)) ([#39](https://github.com/catppuccin/mdBook/pull/39)) 200 | 201 | ### Documentation 202 | 203 | - general: 204 | - add example mdBook ([3469e9e](https://github.com/catppuccin/mdBook/commit/3469e9ee873fa395396f374a33b3a0f1b5c5d5b4)) ([#45](https://github.com/catppuccin/mdBook/pull/45)) 205 | 206 | - README: 207 | - standardise with template repository ([3844bd1](https://github.com/catppuccin/mdBook/commit/3844bd10008bd5dabc8fba5ecf3b691c6830daba)) ([#45](https://github.com/catppuccin/mdBook/pull/45)) 208 | 209 | ### Refactor 210 | 211 | - general: 212 | - links should be `blue` ([6cce7d0](https://github.com/catppuccin/mdBook/commit/6cce7d0264b0e813974ce8b3967c249ed90a34ab)) ([#45](https://github.com/catppuccin/mdBook/pull/45)) 213 | 214 | ## [v0.1.1](https://github.com/catppuccin/mdBook/releases/tag/v0.1.1) - 2022-08-27 21:05:04 215 | 216 | _No description_ 217 | 218 | ### Bug Fixes 219 | 220 | - general: 221 | - Add 'ayu' back into index.hbs ([45220f0](https://github.com/catppuccin/mdBook/commit/45220f0fcca322f5c1b3285371b84942daae3d70)) ([#1](https://github.com/catppuccin/mdBook/pull/1)) 222 | 223 | ### Documentation 224 | 225 | - README: 226 | - Add ayu into diff codeblock example ([b68dac3](https://github.com/catppuccin/mdBook/commit/b68dac3c77ac55c4467ba2e1c8746774a12445a8)) ([#1](https://github.com/catppuccin/mdBook/pull/1)) 227 | - Add binaries section ([9f7bae8](https://github.com/catppuccin/mdBook/commit/9f7bae8045f1312d1cc20decf8780c02325e98f1)) 228 | - Update link for index.hbs ([200008e](https://github.com/catppuccin/mdBook/commit/200008e7b237ffe2b7895a6792bded9ed30cd335)) 229 | 230 | ## [v0.1.0](https://github.com/catppuccin/mdBook/releases/tag/v0.1.0) - 2022-08-27 12:47:37 231 | 232 | 🎉 The first-ever release of mdbook-catppuccin 🎉 233 | 234 |  235 | 236 | ### Feature 237 | 238 | - general: 239 | 240 | - Refactor + Wrap up port ([9ba9813](https://github.com/catppuccin/mdBook/commit/9ba9813fd3d1ac75106cc2b0add0ae6627aae2c4)) 241 | - Fix codeblock colours ([e93f034](https://github.com/catppuccin/mdBook/commit/e93f0347722d3bd6ce5caa81cccbc93d0b205db6)) 242 | - Generate catppuccin flavours with sass ([44144a2](https://github.com/catppuccin/mdBook/commit/44144a2512265c0eb6d1376a1da4c0be1cf43894)) 243 | 244 | - mdbook: 245 | 246 | - Add insert_dotted_table() ([37620fe](https://github.com/catppuccin/mdBook/commit/37620fe8c375ba4eaf54ae70a086445b82bc7a1c)) 247 | 248 | - scss: 249 | - Generate css for .hjls ([c151055](https://github.com/catppuccin/mdBook/commit/c1510551c54cc3bc1c5751a6769fdcca3531f3e4)) 250 | 251 | ### Bug Fixes 252 | 253 | - general: 254 | - Fix white background colour ([38514d4](https://github.com/catppuccin/mdBook/commit/38514d4f5c670d197e8c10fe07d3fff5f182ccb8)) 255 | - Update assets and resolve highlights ([caedfd0](https://github.com/catppuccin/mdBook/commit/caedfd094ae0be4421cf4f235ab80dfdfb929c33)) 256 | 257 | ### Documentation 258 | 259 | - README: 260 | 261 | - Tidy up diff codeblock ([5bd3618](https://github.com/catppuccin/mdBook/commit/5bd3618abc00b3b306d87952621b7a43cbb52908)) 262 | - Update badge links ([9ab04ba](https://github.com/catppuccin/mdBook/commit/9ab04ba20b3ecafd832753f0371a9ed22ecd1b28)) 263 | - Import template from catppuccin ([00b5f47](https://github.com/catppuccin/mdBook/commit/00b5f4765c6e84d3ab80d383d922f2299fad88a3)) 264 | 265 | - general: 266 | - Update description of crate ([686e801](https://github.com/catppuccin/mdBook/commit/686e80150cb382e58e7ebe90d574843d062cf879)) 267 | - Add binaries bullet point ([c960264](https://github.com/catppuccin/mdBook/commit/c960264bf5eabff96e6c797defa62e8ab67506e8)) 268 | - Update README & upload catwalk image ([1b945c5](https://github.com/catppuccin/mdBook/commit/1b945c50313311500987a543cb3d7d2f70da0c32)) 269 | 270 | ### Refactor 271 | 272 | - general: 273 | 274 | - No need for individual images ([af14a54](https://github.com/catppuccin/mdBook/commit/af14a542bae658a58673741cf762f7841fb266b6)) 275 | - Remove useless comment ([db3cf56](https://github.com/catppuccin/mdBook/commit/db3cf5607bafb25873d50c8b993512f286c10ddb)) 276 | - Remove unused code ([bc01543](https://github.com/catppuccin/mdBook/commit/bc015432546dcf99695b10edd2333d6fd8d6fe25)) 277 | - Remove old commented css ([56b47b3](https://github.com/catppuccin/mdBook/commit/56b47b39cf6980b68739a3496b56b2a329a966c8)) 278 | 279 | - assets: 280 | 281 | - Create separate file for highlights ([a69a8de](https://github.com/catppuccin/mdBook/commit/a69a8de064ccbc10344e3ae30785270cc094c42e)) 282 | - Move src/assets -> src/bin/assets ([444b809](https://github.com/catppuccin/mdBook/commit/444b8096454bf04b2a973766994703523e6c1d3d)) 283 | - Remove ASSETS_VERSION in favour of CARGO_PKG_VERSION ([5384c92](https://github.com/catppuccin/mdBook/commit/5384c929e99a3ce35e28b821419c6f4bb74c4b2f)) 284 | 285 | - mdbook: 286 | 287 | - Extend default toml structs ([48cd282](https://github.com/catppuccin/mdBook/commit/48cd282227ee2de3a2f691176e6c8d81159217f2)) 288 | - Move toml trait extensions into toml.rs ([cbfffa3](https://github.com/catppuccin/mdBook/commit/cbfffa3c944b1934ddac65c50ee8b792b438e4b6)) 289 | - Start highlighting codeblocks + other stuff ([c24d08a](https://github.com/catppuccin/mdBook/commit/c24d08abc6ceb4f6f89fcf6385e52df7a92ce367)) 290 | 291 | - config: 292 | - Use spaces instead of tabs ([3c4d7e0](https://github.com/catppuccin/mdBook/commit/3c4d7e0b1ffc24644fdefbe4b1ca8c344590b87a)) 293 | 294 | \* _This CHANGELOG was automatically generated by [auto-generate-changelog](https://github.com/BobAnkh/auto-generate-changelog)_ 295 | -------------------------------------------------------------------------------- /LICENSE: -------------------------------------------------------------------------------- 1 | MIT License 2 | 3 | Copyright (c) 2021 Catppuccin 4 | 5 | Permission is hereby granted, free of charge, to any person obtaining a copy 6 | of this software and associated documentation files (the "Software"), to deal 7 | in the Software without restriction, including without limitation the rights 8 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell 9 | copies of the Software, and to permit persons to whom the Software is 10 | furnished to do so, subject to the following conditions: 11 | 12 | The above copyright notice and this permission notice shall be included in all 13 | copies or substantial portions of the Software. 14 | 15 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 16 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 17 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE 18 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER 19 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, 20 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE 21 | SOFTWARE. 22 | -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 |
16 |
17 |
151 |
152 |
155 | Copyright © 2021-present Catppuccin Org 156 |
157 | 158 | 161 | -------------------------------------------------------------------------------- /assets/catwalk.webp: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/catppuccin/mdBook/666695ac488678b8fd1a15d73d0bd164d2d08a46/assets/catwalk.webp -------------------------------------------------------------------------------- /assets/frappe.webp: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/catppuccin/mdBook/666695ac488678b8fd1a15d73d0bd164d2d08a46/assets/frappe.webp -------------------------------------------------------------------------------- /assets/latte.webp: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/catppuccin/mdBook/666695ac488678b8fd1a15d73d0bd164d2d08a46/assets/latte.webp -------------------------------------------------------------------------------- /assets/macchiato.webp: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/catppuccin/mdBook/666695ac488678b8fd1a15d73d0bd164d2d08a46/assets/macchiato.webp -------------------------------------------------------------------------------- /assets/mocha.webp: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/catppuccin/mdBook/666695ac488678b8fd1a15d73d0bd164d2d08a46/assets/mocha.webp -------------------------------------------------------------------------------- /example/.gitignore: -------------------------------------------------------------------------------- 1 | # mdbook build directory 2 | book -------------------------------------------------------------------------------- /example/book.toml: -------------------------------------------------------------------------------- 1 | [book] 2 | authors = ["sgoudham"] 3 | language = "en" 4 | multilingual = false 5 | src = "src" 6 | title = "Catppuccin's mdBook" 7 | 8 | [preprocessor.admonish] 9 | command = "mdbook-admonish" 10 | assets_version = "3.0.3" # do not edit: managed by `mdbook-admonish install` 11 | 12 | [preprocessor.alerts] 13 | 14 | [output.html] 15 | default-theme = "latte" 16 | preferred-dark-theme = "mocha" 17 | additional-css = [ 18 | "./theme/catppuccin.css", 19 | "./theme/catppuccin-admonish.css", 20 | "./theme/mdbook-admonish.css", 21 | "./theme/catppuccin-alerts.css", 22 | ] 23 | no-section-label = true 24 | git-repository-url = "https://github.com/catppuccin/mdBook" 25 | git-repository-icon = "fa-github" 26 | edit-url-template = "https://github.com/catppuccin/mdBook/edit/main/example/{path}" 27 | cname = "mdbook.catppuccin.com" 28 | -------------------------------------------------------------------------------- /example/src/SUMMARY.md: -------------------------------------------------------------------------------- 1 | # Summary 2 | 3 | - [Landing](./landing.md) 4 | - [Admonishments](./admonish.md) 5 | - [Alerts](./alerts.md) 6 | - [Super Secret](./secret.md) 7 | -------------------------------------------------------------------------------- /example/src/admonish.md: -------------------------------------------------------------------------------- 1 | # Reference 2 | 3 | The following admonishments are implemented by the 4 | [mdbook-admonish](https://github.com/tommilligan/mdbook-admonish) plugin and are 5 | automatically themed to match Catppuccin. 6 | 7 | ## Directives 8 | 9 | All supported directives are listed below. 10 | 11 | `note` 12 | 13 | ```admonish note 14 | Rust is a multi-paradigm, general-purpose programming language designed for performance and safety, especially safe concurrency. 15 | ``` 16 | 17 | `abstract`, `summary`, `tldr` 18 | 19 | ```admonish abstract 20 | Rust is a multi-paradigm, general-purpose programming language designed for performance and safety, especially safe concurrency. 21 | ``` 22 | 23 | `info`, `todo` 24 | 25 | ```admonish info 26 | Rust is a multi-paradigm, general-purpose programming language designed for performance and safety, especially safe concurrency. 27 | ``` 28 | 29 | `tip`, `hint`, `important` 30 | 31 | ```admonish tip 32 | Rust is a multi-paradigm, general-purpose programming language designed for performance and safety, especially safe concurrency. 33 | ``` 34 | 35 | `success`, `check`, `done` 36 | 37 | ```admonish success 38 | Rust is a multi-paradigm, general-purpose programming language designed for performance and safety, especially safe concurrency. 39 | ``` 40 | 41 | `question`, `help`, `faq` 42 | 43 | ```admonish question 44 | Rust is a multi-paradigm, general-purpose programming language designed for performance and safety, especially safe concurrency. 45 | ``` 46 | 47 | `warning`, `caution`, `attention` 48 | 49 | ```admonish warning 50 | Rust is a multi-paradigm, general-purpose programming language designed for performance and safety, especially safe concurrency. 51 | ``` 52 | 53 | `failure`, `fail`, `missing` 54 | 55 | ```admonish failure 56 | Rust is a multi-paradigm, general-purpose programming language designed for performance and safety, especially safe concurrency. 57 | ``` 58 | 59 | `danger`, `error` 60 | 61 | ```admonish danger 62 | Rust is a multi-paradigm, general-purpose programming language designed for performance and safety, especially safe concurrency. 63 | ``` 64 | 65 | `bug` 66 | 67 | ```admonish bug 68 | Rust is a multi-paradigm, general-purpose programming language designed for performance and safety, especially safe concurrency. 69 | ``` 70 | 71 | `example` 72 | 73 | ```admonish example 74 | Rust is a multi-paradigm, general-purpose programming language designed for performance and safety, especially safe concurrency. 75 | ``` 76 | 77 | `quote`, `cite` 78 | 79 | ```admonish quote 80 | Rust is a multi-paradigm, general-purpose programming language designed for performance and safety, especially safe concurrency. 81 | ``` 82 | -------------------------------------------------------------------------------- /example/src/alerts.md: -------------------------------------------------------------------------------- 1 | # Reference 2 | 3 | The following alerts are implemented by the 4 | [mdbook-alerts](https://github.com/lambdalisue/rs-mdbook-alerts) plugin and are 5 | automatically themed to match Catppuccin. 6 | 7 | ## Alerts 8 | 9 | All supported alerts are listed below. 10 | 11 | > [!NOTE] 12 | > Highlights information that users should take into account, even when skimming. 13 | 14 | > [!TIP] 15 | > Optional information to help a user be more successful. 16 | 17 | > [!IMPORTANT] 18 | > Crucial information necessary for users to succeed. 19 | 20 | > [!WARNING] 21 | > Critical content demanding immediate user attention due to potential risks. 22 | 23 | > [!CAUTION] 24 | > Negative potential consequences of an action. 25 | -------------------------------------------------------------------------------- /example/src/landing.md: -------------------------------------------------------------------------------- 1 | # Example Markdown Document 2 | 3 | ## Information 4 | 5 | **crates.io**: [https://crates.io/crates/mdbook-catppuccin](https://crates.io/crates/mdbook-catppuccin) 6 | 7 | **repository**: [https://github.com/catppuccin/mdBook](https://github.com/catppuccin/mdBook) 8 | 9 | ## Text 10 | 11 | Here is a paragraph with bold text. **This is some bold text.** Here is a 12 | paragraph with bold text. **This is also some bold text.** 13 | 14 | Here is another one with italic text. _This is some italic text._ Here is 15 | another one with italic text. _This is some italic text._ 16 | 17 | Here is another one with struckout text. ~~This is some struckout text.~~ 18 | 19 |Implementation note: The sorting algorithm is a Dual-Pivot Quicksort 85 | * by Vladimir Yaroslavskiy, Jon Bentley, and Joshua Bloch. This algorithm 86 | * offers O(n log(n)) performance on many data sets that cause other 87 | * quicksorts to degrade to quadratic performance, and is typically 88 | * faster than traditional (one-pivot) Quicksort implementations. 89 | * 90 | * @param a the array to be sorted 91 | */ 92 | public static void sort(byte[] a) { 93 | DualPivotQuicksort.sort(a); 94 | } 95 | 96 | ## Quotes 97 | 98 | > This is the first level of quoting. 99 | > 100 | > > This is nested blockquote. 101 | > 102 | > Back to the first level. 103 | 104 | > A list within a blockquote: 105 | > 106 | > - asterisk 1 107 | > - asterisk 2 108 | > - asterisk 3 109 | 110 | > Formatting within a blockquote: 111 | > 112 | > ### header 113 | > 114 | > Link: [Example](http://example.com) 115 | 116 | ## Html 117 | 118 | This is inline html