Updated Insiders documentation

This commit is contained in:
squidfunk 2021-01-17 12:42:46 +01:00
parent ca4d7f3db7
commit abea8c8187
5 changed files with 84 additions and 46 deletions

View File

@ -1,3 +1,8 @@
mkdocs-material-6.2.5+insiders-1.16.0 (2021-01-17)
* Added latest release to repository info (GitHub)
* Slight facelift of repsitory info (lighter fonts, spacing and icons)
mkdocs-material-6.2.5 (2021-01-17) mkdocs-material-6.2.5 (2021-01-17)
* Fixed syntax error in Swedish translations * Fixed syntax error in Swedish translations

Binary file not shown.

After

Width:  |  Height:  |  Size: 344 KiB

View File

@ -6,6 +6,11 @@ template: overrides/main.html
## Material for MkDocs Insiders ## Material for MkDocs Insiders
### 1.16.0 <small>_ January 7, 2021</small>
- Added latest release to repository info (GitHub)
- Slight facelift of repsitory info (lighter fonts, spacing and icons)
### 1.15.0 <small>_ January 2, 2021</small> ### 1.15.0 <small>_ January 2, 2021</small>
- Added support for native Mermaid.js integration - Added support for native Mermaid.js integration

View File

@ -100,16 +100,17 @@ The following features are currently exclusively available to sponsors:
<div class="tx-columns" markdown="1"> <div class="tx-columns" markdown="1">
- [x] [Color palette toggle][15] - [x] [Latest release tag :material-new-box:][15]
- [x] [Color palette toggle][16]
- [x] [Versioning][14] - [x] [Versioning][14]
- [x] [Site language selection][13] - [x] [Site language selection][13]
- [x] [Sticky navigation tabs][19] - [x] [Sticky navigation tabs][20]
- [x] [Native Mermaid.js integration][21] - [x] [Native Mermaid.js integration][22]
- [x] [Admonition inline blocks][12] - [x] [Admonition inline blocks][12]
- [x] [Search suggestions][16] - [x] [Search suggestions][17]
- [x] [Search highlighting][17] - [x] [Search highlighting][18]
- [x] [Search sharing][18] - [x] [Search sharing][19]
- [x] [Remove generator notice][20] - [x] [Remove generator notice][21]
</div> </div>
@ -139,39 +140,41 @@ the public for general availability.
#### $ 2,000 Black Pearl #### $ 2,000 Black Pearl
- [x] [Color palette toggle][15] - [x] [Latest release tag][15]
- [x] [Color palette toggle][16]
- [ ] Code block palette toggle - [ ] Code block palette toggle
[15]: setup/changing-the-colors.md#color-palette-toggle [15]: setup/adding-a-git-repository.md#latest-release
[16]: setup/changing-the-colors.md#color-palette-toggle
#### $ 2,500 Biquinho Vermelho #### $ 2,500 Biquinho Vermelho
- [x] [Search suggestions][16] - [x] [Search suggestions][17]
- [x] [Search highlighting][17] - [x] [Search highlighting][18]
- [x] [Search sharing][18] - [x] [Search sharing][19]
[16]: setup/setting-up-site-search.md#search-suggestions [17]: setup/setting-up-site-search.md#search-suggestions
[17]: setup/setting-up-site-search.md#search-highlighting [18]: setup/setting-up-site-search.md#search-highlighting
[18]: setup/setting-up-site-search.md#search-sharing [19]: setup/setting-up-site-search.md#search-sharing
#### $ 3,000 Caribbean Red #### $ 3,000 Caribbean Red
- [x] [Sticky navigation tabs][19] - [x] [Sticky navigation tabs][20]
- [x] [Remove generator notice][20] - [x] [Remove generator notice][21]
- [ ] Support for index pages - [ ] Support for index pages
[19]: setup/setting-up-navigation.md#sticky-navigation-tabs [20]: setup/setting-up-navigation.md#sticky-navigation-tabs
[20]: setup/setting-up-the-footer.md#remove-generator [21]: setup/setting-up-the-footer.md#remove-generator
#### $ 5,000 - Aji Panca #### $ 5,000 - Aji Panca
- [x] [Native Mermaid.js integration][21] - [x] [Native Mermaid.js integration][22]
[21]: reference/diagrams.md [22]: reference/diagrams.md
#### Future #### Future
- [ ] [Material for MkDocs Live Edit][22] - [ ] [Material for MkDocs Live Edit][23]
- [ ] Improved search result summaries - [ ] Improved search result summaries
- [ ] List of last searches - [ ] List of last searches
- [ ] Table of contents follows active anchor - [ ] Table of contents follows active anchor
@ -181,7 +184,7 @@ the public for general availability.
- [ ] New layouts and styles (e.g. vertical) - [ ] New layouts and styles (e.g. vertical)
- [ ] ... and much more ... - [ ] ... and much more ...
[22]: https://twitter.com/squidfunk/status/1338252230265360391 [23]: https://twitter.com/squidfunk/status/1338252230265360391
### Goals completed ### Goals completed
@ -217,10 +220,10 @@ implemented behind feature flags; all configuration changes are
backward-compatible. This means that your users will be able to build the backward-compatible. This means that your users will be able to build the
documentation locally with Material for MkDocs and when they push their changes, documentation locally with Material for MkDocs and when they push their changes,
it can be built with Insiders (e.g. as part of GitHub Actions). Thus, it's it can be built with Insiders (e.g. as part of GitHub Actions). Thus, it's
recommended to [install Insiders][23] only in CI, as you don't want to expose recommended to [install Insiders][24] only in CI, as you don't want to expose
your `GH_TOKEN` to users. your `GH_TOKEN` to users.
[23]: publishing-your-site.md#github-pages [24]: publishing-your-site.md#github-pages
### Terms ### Terms
@ -229,7 +232,7 @@ commercial project. Can we use Insiders under the same terms and conditions?_
Yes. Whether you're an individual or a company, you may use _Material for MkDocs Yes. Whether you're an individual or a company, you may use _Material for MkDocs
Insiders_ precisely under the same terms as Material for MkDocs, which are given Insiders_ precisely under the same terms as Material for MkDocs, which are given
by the [MIT license][24]. However, we kindly ask you to respect the following by the [MIT license][25]. However, we kindly ask you to respect the following
guidelines: guidelines:
- Please __don't distribute the source code__ of Insiders. You may freely use - Please __don't distribute the source code__ of Insiders. You may freely use
@ -240,7 +243,7 @@ guidelines:
- If you cancel your subscription, you're removed as a collaborator and will - If you cancel your subscription, you're removed as a collaborator and will
miss out on future updates of Insiders. However, you may __use the latest miss out on future updates of Insiders. However, you may __use the latest
version__ that's available to you __as long as you like__. Just remember that version__ that's available to you __as long as you like__. Just remember that
[GitHub deletes private forks][25]. [GitHub deletes private forks][26].
[24]: license.md [25]: license.md
[25]: https://docs.github.com/en/github/setting-up-and-managing-your-github-user-account/removing-a-collaborator-from-a-personal-repository [26]: https://docs.github.com/en/github/setting-up-and-managing-your-github-user-account/removing-a-collaborator-from-a-personal-repository

View File

@ -72,14 +72,39 @@ Some popular choices:
[4]: https://github.com/squidfunk/mkdocs-material/tree/master/material/.icons [4]: https://github.com/squidfunk/mkdocs-material/tree/master/material/.icons
### Latest release
[:octicons-file-code-24: Source][5] ·
[:octicons-heart-fill-24:{: .tx-heart } Insiders only][5]{: .tx-insiders }
The visual appearance of the repository link has been improved as part of
[Insiders][5], and will now automatically include the latest release tag which
is not marked as a draft or pre-release:
<figure markdown="1">
[![Search suggestions][6]][6]
<figcaption markdown="1">
A demo is worth a thousand words — check it out at
[squidfunk.github.io/mkdocs-material-insiders][7]
</figcaption>
</figure>
[5]: ../insiders.md
[6]: ../assets/screenshots/repository.png
[7]: https://squidfunk.github.io/mkdocs-material-insiders/setup/adding-a-git-repository/
### Edit button ### Edit button
[:octicons-file-code-24: Source][5] · :octicons-milestone-24: Default: [:octicons-file-code-24: Source][8] · :octicons-milestone-24: Default:
_automatically set_ _automatically set_
If the repository URL points to a [GitHub][6], [GitLab][7] or [Bitbucket][8] If the repository URL points to a [GitHub][9], [GitLab][10] or [Bitbucket][11]
repository, an _edit button_ is displayed at the top of each document. This repository, an _edit button_ is displayed at the top of each document. This
behavior can be changed by setting [`edit_uri`][9] in `mkdocs.yml`: behavior can be changed by setting [`edit_uri`][12] in `mkdocs.yml`:
=== "Customize edit path" === "Customize edit path"
@ -93,18 +118,18 @@ behavior can be changed by setting [`edit_uri`][9] in `mkdocs.yml`:
edit_uri: "" edit_uri: ""
``` ```
[5]: https://github.com/squidfunk/mkdocs-material/blob/master/src/base.html [8]: https://github.com/squidfunk/mkdocs-material/blob/master/src/base.html
[6]: https://github.com/ [9]: https://github.com/
[7]: https://about.gitlab.com/ [10]: https://about.gitlab.com/
[8]: https://bitbucket.org/ [11]: https://bitbucket.org/
[9]: https://www.mkdocs.org/user-guide/configuration/#edit_uri [12]: https://www.mkdocs.org/user-guide/configuration/#edit_uri
### Revision date ### Revision date
[:octicons-file-code-24: Source][10] · [:octicons-file-code-24: Source][13] ·
[:octicons-cpu-24: Plugin][11] [:octicons-cpu-24: Plugin][14]
The [git-revision-date][11] plugin adds support for displaying the date a The [git-revision-date][13] plugin adds support for displaying the date a
document was _last updated_ at the bottom of each page. It can be installed document was _last updated_ at the bottom of each page. It can be installed
with `pip`: with `pip`:
@ -137,15 +162,15 @@ _Material for MkDocs doesn't provide official support for the other options of
this plugin, so they may be supported but can also yield weird results. Use this plugin, so they may be supported but can also yield weird results. Use
them at your own risk._ them at your own risk._
[10]: https://github.com/squidfunk/mkdocs-material/blob/master/src/partials/source-date.html [13]: https://github.com/squidfunk/mkdocs-material/blob/master/src/partials/source-date.html
[11]: https://github.com/zhaoterryy/mkdocs-git-revision-date-plugin [14]: https://github.com/zhaoterryy/mkdocs-git-revision-date-plugin
### Revision date, localized ### Revision date, localized
[:octicons-file-code-24: Source][10] · [:octicons-file-code-24: Source][13] ·
[:octicons-cpu-24: Plugin][12] [:octicons-cpu-24: Plugin][15]
Similarly, the [git-revision-date-localized][12] plugin adds support for adding Similarly, the [git-revision-date-localized][15] plugin adds support for adding
a localized _last updated_ date at the bottom of each page. It can be installed a localized _last updated_ date at the bottom of each page. It can be installed
with `pip`: with `pip`:
@ -190,4 +215,4 @@ _Material for MkDocs doesn't provide official support for the other options of
this plugin, so they may be supported but can also yield weird results. Use this plugin, so they may be supported but can also yield weird results. Use
them at your own risk._ them at your own risk._
[12]: https://github.com/timvink/mkdocs-git-revision-date-localized-plugin [15]: https://github.com/timvink/mkdocs-git-revision-date-localized-plugin