mkdocs-material/docs/insiders/index.md

568 lines
27 KiB
Markdown
Raw Normal View History

2020-07-22 17:05:38 +03:00
---
2021-03-21 19:14:32 +03:00
title: Insiders
2020-07-22 17:05:38 +03:00
---
2021-03-21 19:14:32 +03:00
# Insiders
2020-07-22 17:05:38 +03:00
2021-11-07 20:23:01 +03:00
Material for MkDocs follows the __sponsorware__ release strategy, which means
that new features are first exclusively released to sponsors as part of
[Insiders]. Read on to learn [what sponsorships achieve],
[how to become a sponsor] to get access to Insiders, and [what's in it for you]!
2020-12-21 19:38:58 +03:00
2022-10-02 18:50:19 +03:00
<!-- <figure class="mdx-video" markdown>
<div class="mdx-video__inner">
2022-02-27 20:19:04 +03:00
<iframe src="https://streamable.com/e/yslhdu" allowfullscreen></iframe>
2020-12-21 19:38:58 +03:00
</div>
2021-10-05 00:36:31 +03:00
<figcaption markdown>
2021-11-13 14:13:45 +03:00
This documentation is built with Insiders
2021-11-07 20:23:01 +03:00
[squidfunk.github.io/mkdocs-material][Material for MkDocs]
2020-12-21 19:38:58 +03:00
</figcaption>
2022-10-02 18:50:19 +03:00
</figure> -->
2020-12-21 19:38:58 +03:00
2021-11-07 20:23:01 +03:00
[Insiders]: #what-is-insiders
[what sponsorships achieve]: #what-sponsorships-achieve
[how to become a sponsor]: #how-to-become-a-sponsor
[what's in it for you]: #whats-in-it-for-me
2021-11-07 20:23:01 +03:00
[Material for MkDocs]: https://squidfunk.github.io/mkdocs-material/
2020-07-22 17:05:38 +03:00
2021-11-07 20:23:01 +03:00
## What is Insiders?
2020-07-22 18:56:47 +03:00
2021-11-07 20:23:01 +03:00
Material for MkDocs Insiders is a private fork of Material for MkDocs, hosted as
a private GitHub repository. Almost[^1] [all new features][what's in it for you]
2022-04-28 12:16:09 +03:00
are developed as part of this fork, which means that they are immediately
available to all eligible sponsors, as they are made collaborators of this
repository.
2021-02-04 23:14:38 +03:00
[^1]:
2021-11-07 20:23:01 +03:00
In general, every new feature is first exclusively released to sponsors, but
sometimes upstream dependencies like [Python Markdown Extensions] enhance
existing features that must be supported by Material for MkDocs.
Every feature is tied to a [funding goal] in monthly subscriptions. When a
funding goal is hit, the features that are tied to it are merged back into
Material for MkDocs and released for general availability, making them available
to all users. Bugfixes are always released in tandem.
2022-09-01 11:25:57 +03:00
Sponsorships start as low as [__$15 a month__][how to become a sponsor].[^2]
2021-11-07 20:23:01 +03:00
[^2]:
2022-09-01 11:25:57 +03:00
Note that $15 a month is the minimum amount to become eligible for
2021-11-07 20:23:01 +03:00
Insiders. While GitHub Sponsors also allows to sponsor lower amounts or
one-time amounts, those can't be granted access to Insiders due to
technical reasons.
[Python Markdown Extensions]: https://facelessuser.github.io/pymdown-extensions/
2021-11-07 20:28:38 +03:00
[funding goal]: #funding
2021-11-07 20:23:01 +03:00
## What sponsorships achieve
Sponsorships make this project sustainable, as they buy the maintainers of this
project time a very scarce resource which is spent on the development of new
features, bug fixing, stability improvement, issue triage and general support.
The biggest bottleneck in Open Source is time.[^3]
[^3]:
2021-11-07 20:59:18 +03:00
Making an Open Source project sustainable is exceptionally hard: maintainers
burn out, projects are abandoned. That's not great and very unpredictable.
The sponsorware model ensures that if you decide to use Material for MkDocs,
2021-02-04 23:14:38 +03:00
you can be sure that bugs are fixed quickly and new features are added
regularly.
2021-11-07 20:23:01 +03:00
If you're unsure if you should sponsor this project, check out the list of
[completed funding goals] to learn whether you're already using features that
were developed with the help of sponsorships. You're most likely using at least
a handful of them, [thanks to our awesome sponsors]!
2020-12-21 19:38:58 +03:00
2021-11-07 20:23:01 +03:00
[completed funding goals]: #goals-completed
[thanks to our awesome sponsors]: #how-to-become-a-sponsor
2020-07-22 18:56:47 +03:00
2022-12-18 13:05:09 +03:00
<figure style="min-width:15.6rem">
<blockquote class="twitter-tweet" data-conversation="none" data-dnt="true">
<a href="https://twitter.com/WillingCarol/status/1603416470616088576?ref_src=twsrc%5Etfw"></a>
</blockquote>
<script async src="https://platform.twitter.com/widgets.js"></script>
</figure>
## What's in it for me?
2022-07-06 10:00:38 +03:00
The moment you [become a sponsor][how to become a sponsor], you'll get __immediate
2023-12-23 23:32:20 +03:00
access to 23 additional features__ that you can __start using now__, and
2022-07-06 10:00:38 +03:00
which are currently exclusively available to sponsors:
<div class="mdx-columns" markdown>
2023-12-23 23:32:20 +03:00
- [x] [Tags plugin: advanced settings] :material-alert-decagram:{ .mdx-pulse title="Added on December 23, 2023" }
- [x] [Tags plugin: nested tags] :material-alert-decagram:{ .mdx-pulse title="Added on December 23, 2023" }
- [x] [Tags plugin: shadow tags] :material-alert-decagram:{ .mdx-pulse title="Added on December 23, 2023" }
2023-12-08 12:29:59 +03:00
- [x] [Stay on page when switching languages] :material-alert-decagram:{ .mdx-pulse title="Added on December 8, 2023" }
2023-11-26 17:46:58 +03:00
- [x] [Blog plugin: author profiles] :material-alert-decagram:{ .mdx-pulse title="Added on November 26, 2023" }
2023-12-23 23:32:20 +03:00
- [x] [Blog plugin: advanced settings]
2023-12-08 12:29:59 +03:00
- [x] [Projects plugin]
2023-11-26 17:46:58 +03:00
- [x] [Instant prefetching]
- [x] [Social plugin: custom layouts]
- [x] [Social plugin: background images]
2023-06-15 19:02:31 +03:00
- [x] [Code range selection]
2023-05-08 11:25:09 +03:00
- [x] [Code annotations: custom selectors]
- [x] [Privacy plugin: optimization support]
2023-02-19 19:34:12 +03:00
- [x] [Optimize plugin]
- [x] [Navigation path] (Breadcrumbs)
2023-02-06 17:09:32 +03:00
- [x] [Typeset plugin]
2023-01-21 19:58:58 +03:00
- [x] [Privacy plugin: external links]
2023-01-14 22:29:27 +03:00
- [x] [Navigation subtitles]
2022-12-21 00:44:07 +03:00
- [x] [Tags plugin: allow list] + [custom sorting]
2022-10-18 10:32:22 +03:00
- [x] [Blog plugin: custom index pages]
2022-10-02 17:36:47 +03:00
- [x] [Blog plugin: related links]
- [x] [Meta plugin]
2022-09-12 11:47:38 +03:00
- [x] [Tags plugin: additional indexes]
2022-07-06 10:00:38 +03:00
</div>
New features are added every other week. Be sure to come back.
2020-12-21 19:38:58 +03:00
## How to become a sponsor
2021-11-07 20:23:01 +03:00
Thanks for your interest in sponsoring! In order to become an eligible sponsor
with your GitHub account, visit [squidfunk's sponsor profile], and complete
2022-09-01 11:25:57 +03:00
a sponsorship of __$15 a month or more__. You can use your individual or
2021-11-07 20:23:01 +03:00
organization GitHub account for sponsoring.
2020-12-21 19:38:58 +03:00
__Important__: If you're sponsoring @squidfunk through a GitHub organization,
please send a short email to sponsors@squidfunk.com with the name of your
2023-09-15 10:25:50 +03:00
organization and the GitHub account of the individual that should be added as a
2021-11-07 20:23:01 +03:00
collaborator.[^4]
2021-05-30 12:45:36 +03:00
2021-11-07 20:23:01 +03:00
You can cancel your sponsorship anytime.[^5]
2021-05-30 12:45:36 +03:00
2021-11-07 20:23:01 +03:00
[^4]:
2020-12-21 19:38:58 +03:00
It's currently not possible to grant access to each member of an
organization, as GitHub only allows for adding users. Thus, after
sponsoring, please send an email to sponsors@squidfunk.com, stating which
account should become a collaborator of the Insiders repository. We're
working on a solution which will make access to organizations much simpler.
To ensure that access is not tied to a particular individual GitHub account,
create a bot account (i.e. a GitHub account that is not tied to a specific
individual), and use this account for the sponsoring. After being added to
the list of collaborators, the bot account can create a private fork of the
private Insiders GitHub repository, and grant access to all members of the
organizations.
2021-11-07 20:23:01 +03:00
[^5]:
2020-12-22 13:38:28 +03:00
If you cancel your sponsorship, GitHub schedules a cancellation request
2021-05-30 12:45:36 +03:00
which will become effective at the end of the billing cycle. This means
that even though you cancel your sponsorship, you will keep your access to
Insiders as long as your cancellation isn't effective. All charges are
processed by GitHub through Stripe. As we don't receive any information
regarding your payment, and GitHub doesn't offer refunds, sponsorships are
non-refundable.
2020-12-21 19:38:58 +03:00
2021-11-07 20:23:01 +03:00
[:octicons-heart-fill-24:{ .mdx-heart } &nbsp; Join our <span class="mdx-sponsorship-count" data-mdx-component="sponsorship-count"></span> awesome sponsors][squidfunk's sponsor profile]{ .md-button .md-button--primary .mdx-sponsorship-button }
<hr />
2021-10-05 00:36:31 +03:00
<div class="mdx-premium" markdown>
2023-03-28 18:45:39 +03:00
**Silver sponsors**:
[![FastAPI]{ style="height: 120px" }](https://fastapi.tiangolo.com/){ target=_blank title="FastAPI" }
2023-11-09 18:56:54 +03:00
[![Trendpop]{ style="height: 120px" }](https://www.trendpop.com/){ target=_blank title="Trendpop" }
2023-03-28 18:45:39 +03:00
**Bronze sponsors**:
[![Cirrus CI]](https://cirrus-ci.org/){ target=_blank title="Cirrus CI" }
2021-11-07 20:23:01 +03:00
[![Basler]](https://docs.baslerweb.com/){ target=_blank title="Basler" }
[![KX]](https://kx.com/){ target=_blank title="KX Systems" }
[![Manticore Games]](https://www.manticoregames.com/){ target=_blank title="Manticore Games" }
2021-11-10 10:43:38 +03:00
[![Prefect]](https://orion-docs.prefect.io/){ target=_blank title="Prefect" }
2022-02-09 20:07:43 +03:00
[![Datadog]](https://datadoghq.com/){ target=_blank title="Datadog" }
2022-02-10 23:12:05 +03:00
[![Zenoss]](https://zenoss.com/){ target=_blank title="Zenoss" }
[![Posit]](https://docs.posit.co){ target=_blank title="Posit" }
2022-04-13 10:42:16 +03:00
[![n8n]](https://n8n.io){ target=_blank title="n8n" }
2022-06-07 17:38:02 +03:00
[![Dogado]](https://www.dogado.de){ target=_blank title="Dogado" }
[![World Wide Technology]](https://wwt.com){ target=_blank title="World Wide Technology" }
2022-06-24 13:57:46 +03:00
[![Coda]](https://coda.io){ target=_blank title="Coda" }
2022-06-30 18:08:35 +03:00
[![Elastic]](https://elastic.co){ target=_blank title="Elastic" }
2022-07-13 10:51:50 +03:00
[![IP Fabric]](https://ipfabric.io/){ target=_blank title="IP Fabric" }
2022-07-14 12:42:36 +03:00
[![Apex.AI]](https://www.apex.ai/){ target=_blank title="Apex.AI" }
2022-08-26 09:34:55 +03:00
[![Jitterbit]](https://jitterbit.com/){ target=_blank title="Jitterbit" }
[![Sparkfun]](https://sparkfun.com/){ target=_blank title="Sparkfun Electronics" }
2022-09-25 11:18:29 +03:00
[![Eccenca]](https://eccenca.com/){ target=_blank title="Eccenca" }
2022-09-30 10:13:17 +03:00
[![Neptune]](https://neptune.ai/){ target=_blank title="Neptune" }
2022-12-31 15:12:45 +03:00
[![RackN]](https://rackn.com/){ target=_blank title="RackN" }
2023-02-03 15:51:44 +03:00
[![CivicActions]](https://civicactions.com/){ target=_blank title="CivicActions" }
2023-04-03 10:06:06 +03:00
[![bitcrowd]](https://bitcrowd.net/){ target=_blank title="bitcrowd" }
2023-04-17 12:25:41 +03:00
[![GetScreen.me]](https://getscreen.me/){ target=_blank title="GetScreen.me" }
[![BotCity]](https://botcity.dev/){ target=_blank title="BotCity" }
[![Springer Nature Technology]](https://www.springernature.com/gp){ target=_blank title="Springer Nature Technology" }
2023-06-13 11:19:14 +03:00
[![Kolena]](https://kolena.io/){ target=_blank title="Kolena" }
[![Evergiving]](https://www.evergiving.com/){ target=_blank title="Evergiving" }
2023-06-20 13:19:45 +03:00
[![Koor]](https://koor.tech/){ target=_blank title="Koor" }
2023-07-07 10:37:30 +03:00
[![Astral]](https://astral.sh/){ target=_blank title="Astral" }
2023-07-07 17:03:11 +03:00
[![Oikolab]](https://oikolab.com/){ target=_blank title="Oikolab" }
2023-08-26 10:58:03 +03:00
[![Bühler Group]](https://www.buhlergroup.com/){ target=_blank title="Bühler Group" }
2023-09-11 10:04:04 +03:00
[![Transformation Flow]](https://transformationflow.io/){ target=_blank title="Transformation Flow" }
2023-10-27 14:19:02 +03:00
[![3DR]](https://3dr.com/){ target=_blank title="3DR" }
</div>
2023-03-28 18:45:39 +03:00
[FastAPI]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-fastapi.png
2023-11-09 18:56:54 +03:00
[Trendpop]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-trendpop.png
2021-11-07 20:23:01 +03:00
[Cirrus CI]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-cirrus-ci.png
[Basler]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-basler.png
[KX]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-kx.png
[Manticore Games]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-manticore-games.png
2021-11-10 10:43:38 +03:00
[Prefect]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-prefect.png
2022-02-09 20:07:43 +03:00
[Datadog]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-datadog.png
2022-02-10 23:12:05 +03:00
[Zenoss]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-zenoss.png
2023-03-17 17:42:04 +03:00
[Posit]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-posit.png
2022-04-13 10:42:16 +03:00
[n8n]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-n8n.png
2022-06-07 17:38:02 +03:00
[Dogado]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-dogado.png
[World Wide Technology]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-wwt.png
2022-06-24 13:57:46 +03:00
[Coda]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-coda.png
2022-06-30 18:08:35 +03:00
[Elastic]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-elastic.png
2022-07-13 10:51:50 +03:00
[IP Fabric]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-ip-fabric.png
2022-07-14 12:42:36 +03:00
[Apex.AI]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-apex-ai.png
2022-08-26 09:34:55 +03:00
[Jitterbit]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-jitterbit.png
[Sparkfun]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-sparkfun.png
2022-09-25 11:18:29 +03:00
[Eccenca]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-eccenca.png
2022-09-30 10:13:17 +03:00
[Neptune]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-neptune-ai.png
2022-11-08 21:00:08 +03:00
[Cash App]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-cashapp.png
2022-12-31 15:12:45 +03:00
[RackN]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-rackn.png
2023-02-03 15:51:44 +03:00
[CivicActions]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-civic-actions.png
2023-04-03 10:06:06 +03:00
[bitcrowd]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-bitcrowd.png
2023-04-17 12:25:41 +03:00
[GetScreen.me]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-getscreenme.png
[BotCity]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-botcity.png
[Springer Nature Technology]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-sn-technology.png
2023-06-13 11:19:14 +03:00
[Kolena]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-kolena.png
[Evergiving]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-evergiving.png
2023-06-20 13:19:45 +03:00
[Koor]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-koor.png
2023-07-07 10:37:30 +03:00
[Astral]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-astral.png
2023-07-07 17:03:11 +03:00
[Oikolab]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-oikolab.png
2023-08-26 10:58:03 +03:00
[Bühler Group]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-buhler.png
2023-09-11 10:04:04 +03:00
[Transformation Flow]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-transformationflow.png
2023-10-27 14:19:02 +03:00
[3DR]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-3dr.png
<hr />
<div class="mdx-sponsorship" data-mdx-component="sponsorship" hidden>
<div class="mdx-sponsorship__list"></div>
<small>
If you sponsor publicly, you're automatically added here with a link to
your profile and avatar to show your support for Material for MkDocs.
Alternatively, if you wish to keep your sponsorship private, you'll be a
silent +1. You can select visibility during checkout and change it
afterwards.
</small>
2020-11-26 13:54:13 +03:00
</div>
2020-12-21 19:38:58 +03:00
2022-12-14 19:48:29 +03:00
[squidfunk's sponsor profile]: https://github.com/sponsors/squidfunk?metadata_origin=docs
2020-07-22 18:56:47 +03:00
## Funding <span class="mdx-sponsorship-total" data-mdx-component="sponsorship-total"></span>
2020-07-26 15:46:09 +03:00
2020-12-21 19:38:58 +03:00
### Goals
2020-07-26 15:46:09 +03:00
2021-11-07 20:23:01 +03:00
The following section lists all funding goals. Each goal contains a list of
features prefixed with a checkmark symbol, denoting whether a feature is
2023-09-15 10:25:50 +03:00
:octicons-check-circle-fill-24:{ style="color: #00e676" } already available or
2021-11-07 20:23:01 +03:00
:octicons-check-circle-fill-24:{ style="color: var(--md-default-fg-color--lightest)" } planned, but not yet implemented. When the funding goal is hit, the features
are released for general availability.
2022-06-04 14:29:47 +03:00
#### $ 16,000 Chipotle
- [x] [Meta plugin]
2022-09-12 11:47:38 +03:00
- [x] [Blog plugin: related links]
- [x] [Blog plugin: custom index pages]
2022-09-12 11:47:38 +03:00
- [x] [Tags plugin: additional indexes]
2023-02-19 19:34:12 +03:00
- [x] [Tags plugin: allow list] + [custom sorting]
2022-10-02 17:36:47 +03:00
- [x] [Navigation subtitles]
2022-06-04 14:29:47 +03:00
2023-09-15 10:25:50 +03:00
[Meta plugin]: ../plugins/meta.md
2022-09-11 20:25:40 +03:00
[Blog plugin: related links]: ../setup/setting-up-a-blog.md#adding-related-links
[Blog plugin: custom index pages]: ../setup/setting-up-a-blog.md#custom-index-pages
2022-10-02 17:36:47 +03:00
[Tags plugin: additional indexes]: ../setup/setting-up-tags.md#+tags.tags_extra_files
[Tags plugin: allow list]: ../setup/setting-up-tags.md#+tags.tags_allowed
2022-11-02 19:59:29 +03:00
[custom sorting]: ../setup/setting-up-tags.md#+tags.tags_compare
2022-10-02 17:36:47 +03:00
[Navigation subtitles]: ../reference/index.md#setting-the-page-subtitle
#### $ 20,000 Jalapeño
2023-01-21 19:58:58 +03:00
- [x] [Optimize plugin]
2022-12-21 00:44:07 +03:00
- [x] [Typeset plugin]
2023-01-14 22:29:27 +03:00
- [x] [Navigation path] (Breadcrumbs)
2023-02-06 17:09:32 +03:00
- [x] [Privacy plugin: optimization support]
2023-02-19 19:34:12 +03:00
- [x] [Privacy plugin: external links]
2023-06-15 19:02:31 +03:00
- [x] [Instant prefetching]
2023-11-26 17:46:58 +03:00
- [x] [Blog plugin: advanced settings]
- [x] [Blog plugin: author profiles]
2022-10-02 17:36:47 +03:00
2023-09-15 10:25:50 +03:00
[Optimize plugin]: ../plugins/optimize.md
[Typeset plugin]: ../plugins/typeset.md
2023-05-09 11:00:30 +03:00
[Privacy plugin: external links]: ../setup/ensuring-data-privacy.md#+privacy.links
[Privacy plugin: optimization support]: ../setup/ensuring-data-privacy.md#+privacy.assets_include
2023-01-14 22:29:27 +03:00
[Navigation path]: ../setup/setting-up-navigation.md#navigation-path
2023-06-15 19:02:31 +03:00
[Instant prefetching]: ../setup/setting-up-navigation.md#instant-prefetching
2023-11-26 17:46:58 +03:00
[Blog plugin: advanced settings]: ../setup/setting-up-a-blog.md#advanced-settings
2023-11-26 18:53:51 +03:00
[Blog plugin: author profiles]: ../setup/setting-up-a-blog.md#adding-author-profiles
2022-02-20 21:49:23 +03:00
2023-01-29 23:27:15 +03:00
#### $ 24,000 Blockpaprika
2023-07-29 18:24:22 +03:00
- [x] [Projects plugin]
2023-05-08 11:25:09 +03:00
- [x] [Social plugin: custom layouts]
- [x] [Social plugin: background images]
2023-02-19 19:34:12 +03:00
- [x] [Code range selection]
- [x] [Code annotations: custom selectors]
2023-12-08 12:29:59 +03:00
- [x] [Stay on page when switching languages]
2023-12-23 23:32:20 +03:00
- [x] [Tags plugin: nested tags]
- [x] [Tags plugin: shadow tags]
2023-02-19 19:34:12 +03:00
2023-09-15 10:25:50 +03:00
[Projects plugin]: ../plugins/projects.md
2023-05-08 17:44:39 +03:00
[Social plugin: custom layouts]: ../setup/setting-up-social-cards.md#customization
2023-05-08 11:25:09 +03:00
[Social plugin: background images]: ../setup/setting-up-social-cards.md#+social.cards_layout_params.background_image
2023-02-19 19:34:12 +03:00
[Code range selection]: ../reference/code-blocks.md#code-selection-button
[Code annotations: custom selectors]: ../reference/code-blocks.md#custom-selectors
2023-12-08 12:29:59 +03:00
[Stay on page when switching languages]: ../setup/changing-the-language.md#stay-on-page
2023-12-23 23:32:20 +03:00
[Tags plugin: nested tags]: ../plugins/tags.md#config.tags_hierarchy
[Tags plugin: shadow tags]: ../plugins/tags.md#config.shadow
#### $ 28,000 Lemon Drop
- [x] [Tags plugin: advanced settings]
[Tags plugin: advanced settings]: ../setup/setting-up-tags.md#advanced-settings
2023-01-29 23:27:15 +03:00
2020-12-21 19:38:58 +03:00
### Goals completed
2021-11-07 20:23:01 +03:00
This section lists all funding goals that were previously completed, which means
that those features were part of Insiders, but are now generally available and
can be used by all users.
2023-12-07 13:56:18 +03:00
#### $ 14,000 Goat's Horn
- [x] [Privacy plugin]
- [x] [Card grids]
- [x] [Tooltips]
- [x] [Content tabs: anchor links]
- [x] [Automatic light / dark mode]
- [x] [Document contributors]
[Privacy plugin]: ../setup/ensuring-data-privacy.md#built-in-privacy-plugin
[Card grids]: ../reference/grids.md
[Tooltips]: ../reference/tooltips.md
[Content tabs: anchor links]: ../reference/content-tabs.md#anchor-links
[Automatic light / dark mode]: ../setup/changing-the-colors.md#automatic-light-dark-mode
[Document contributors]: ../setup/adding-a-git-repository.md#document-contributors
2023-07-06 18:38:39 +03:00
#### $ 12,000 Piri Piri
- [x] [Blog plugin]
- [x] [Chinese search support]
- [x] [Annotations]
- [x] [Navigation icons]
- [x] [Navigation pruning]
- [x] [Navigation status]
[Blog plugin]: ../setup/setting-up-a-blog.md
[Chinese search support]: ../blog/posts/chinese-search-support.md
[Annotations]: ../reference/annotations.md
[Navigation icons]: ../reference/index.md#setting-the-page-icon
[Navigation pruning]: ../setup/setting-up-navigation.md#navigation-pruning
[Navigation status]: ../reference/index.md#setting-the-page-status
2022-12-07 18:29:53 +03:00
#### $ 10,000 Carolina Reaper
- [x] [Brand new search plugin]
- [x] [Rich search previews]
- [x] [Tokenizer with lookahead]
- [x] [Advanced search highlighting]
- [x] [Excluding content from search]
- [x] [Offline plugin]
[Brand new search plugin]: ../blog/posts/search-better-faster-smaller.md
[Rich search previews]: ../blog/posts/search-better-faster-smaller.md#rich-search-previews
[Tokenizer with lookahead]: ../blog/posts/search-better-faster-smaller.md#tokenizer-lookahead
[Advanced search highlighting]: ../blog/posts/search-better-faster-smaller.md#accurate-highlighting
[Excluding content from search]: ../setup/setting-up-site-search.md#search-exclusion
[Offline plugin]: ../setup/building-for-offline-usage.md
2022-09-13 14:27:13 +03:00
#### $ 8,000 Scotch Bonnet
- [x] [Social cards]
2023-02-19 19:34:12 +03:00
- [x] Code annotations: anchor links
2022-09-13 14:27:13 +03:00
- [x] [Code annotations: strip comments]
- [x] [Tag icons]
- [x] [Table of contents anchor following]
- [x] Sidebars automatically scroll to active item
[Social cards]: ../setup/setting-up-social-cards.md
[Code annotations: strip comments]: ../reference/code-blocks.md#stripping-comments
2022-10-22 09:43:36 +03:00
[Tag icons]: ../setup/setting-up-tags.md#tag-icons-and-identifiers
2022-09-13 14:27:13 +03:00
[Table of contents anchor following]: ../setup/setting-up-navigation.md#anchor-following
2022-07-20 18:51:29 +03:00
#### $ 7,000 Royal Gold
- [x] [Cookie consent]
- [x] [Was this page helpful?]
- [x] [Dismissable announcement bar]
2022-09-11 20:25:40 +03:00
[Cookie consent]: ../setup/ensuring-data-privacy.md#cookie-consent
2022-07-20 18:51:29 +03:00
[Was this page helpful?]: ../setup/setting-up-site-analytics.md#was-this-page-helpful
[Dismissable announcement bar]: ../setup/setting-up-the-header.md#mark-as-read
#### $ 6,000 Trinidad Scorpion
- [x] [Boosting pages in search]
- [x] [Custom admonition icons]
- [x] [Linking content tabs]
[Boosting pages in search]: ../setup/setting-up-site-search.md#search-boosting
[Custom admonition icons]: ../reference/admonitions.md#admonition-icons
[Linking content tabs]: ../reference/content-tabs.md#linked-content-tabs
#### $ 5,000 Aji Panca
- [x] [Mermaid.js integration]
- [x] Stay on page when switching versions
- [x] [Tags with search integration]
[Mermaid.js integration]: ../reference/diagrams.md
[Tags with search integration]: ../setup/setting-up-tags.md
2021-11-13 14:22:30 +03:00
#### $ 4,000 Ghost Pepper
- [x] [Anchor tracking]
- [x] [Code annotations]
- [x] [Version warning]
[Anchor tracking]: ../setup/setting-up-navigation.md#anchor-tracking
[Code annotations]: ../reference/code-blocks.md#adding-annotations
[Version warning]: ../setup/setting-up-versioning.md#version-warning
2021-09-23 10:23:42 +03:00
#### $ 3,000 Caribbean Red
2021-11-07 20:23:01 +03:00
- [x] [Sticky navigation tabs]
- [x] [Section index pages]
- [x] [Remove generator notice]
2021-09-23 10:23:42 +03:00
2021-11-07 20:23:01 +03:00
[Sticky navigation tabs]: ../setup/setting-up-navigation.md#sticky-navigation-tabs
[Section index pages]: ../setup/setting-up-navigation.md#section-index-pages
[Remove generator notice]: ../setup/setting-up-the-footer.md#generator-notice
2021-09-23 10:23:42 +03:00
2021-07-21 18:19:05 +03:00
#### $ 2,500 Biquinho Vermelho
2021-11-07 20:23:01 +03:00
- [x] [Search suggestions]
- [x] [Search highlighting]
- [x] [Search sharing]
2021-07-21 18:19:05 +03:00
2021-11-07 20:23:01 +03:00
[Search suggestions]: ../setup/setting-up-site-search.md#search-suggestions
[Search highlighting]: ../setup/setting-up-site-search.md#search-highlighting
[Search sharing]: ../setup/setting-up-site-search.md#search-sharing
2021-07-21 18:19:05 +03:00
2021-03-29 19:59:53 +03:00
#### $ 2,000 Black Pearl
2020-12-21 19:38:58 +03:00
2021-03-29 19:59:53 +03:00
- [x] Latest release tag
2021-11-07 20:23:01 +03:00
- [x] [Color palette toggle]
- [x] [Back-to-top button]
2021-03-29 19:59:53 +03:00
2021-11-07 20:23:01 +03:00
[Color palette toggle]: ../setup/changing-the-colors.md#color-palette-toggle
[Back-to-top button]: ../setup/setting-up-navigation.md#back-to-top-button
2021-03-29 19:59:53 +03:00
#### $ 1,500 Bhut Jolokia
2021-11-07 20:23:01 +03:00
- [x] [Admonition inline blocks]
- [x] [Site language selection]
- [x] [Versioning]
2021-03-29 19:59:53 +03:00
2021-11-07 20:23:01 +03:00
[Admonition inline blocks]: ../reference/admonitions.md#inline-blocks
[Site language selection]: ../setup/changing-the-language.md#site-language-selector
[Versioning]: ../setup/setting-up-versioning.md#versioning
2020-07-22 18:56:47 +03:00
2020-12-21 19:38:58 +03:00
#### $ 1,000 Prairie Fire
2020-07-22 18:56:47 +03:00
2021-11-07 20:23:01 +03:00
- [x] [Navigation sections]
- [x] [Navigation expansion]
- [x] [Hiding the sidebars]
- [x] [Table of contents in navigation]
- [x] [Header hides on scroll]
2020-07-22 18:56:47 +03:00
2021-11-07 20:23:01 +03:00
[Navigation sections]: ../setup/setting-up-navigation.md#navigation-sections
[Navigation expansion]: ../setup/setting-up-navigation.md#navigation-expansion
[Hiding the sidebars]: ../setup/setting-up-navigation.md#hiding-the-sidebars
[Table of contents in navigation]: ../setup/setting-up-navigation.md#navigation-integration
[Header hides on scroll]: ../setup/setting-up-the-header.md#automatic-hiding
2020-07-22 19:30:00 +03:00
2021-03-29 19:59:53 +03:00
#### $ 500 Madame Jeanette
2021-02-23 01:42:26 +03:00
2021-03-29 19:59:53 +03:00
- [x] Improved search result grouping
- [x] Improved search result relevance and scoring
- [x] Missing query terms in search results
2021-02-23 01:42:26 +03:00
2020-09-04 00:18:02 +03:00
## Frequently asked questions
2020-07-22 19:30:00 +03:00
2020-09-04 00:18:02 +03:00
### Compatibility
2022-07-12 19:10:38 +03:00
_We're building an open source project and want to allow outside collaborators
to run and build our documentation locally without having access to Insiders.
Is this still possible?_
2020-09-04 00:18:02 +03:00
2021-11-07 20:23:01 +03:00
Yes. Insiders is compatible with Material for MkDocs. Almost all new features
2022-07-12 18:54:42 +03:00
and configuration options are either backward-compatible or implemented behind
2022-07-12 19:10:38 +03:00
feature flags. When working with outside collaborators, it should be rarely
necessary to change the general appearance of your site. Most Insiders features
enhance the overall experience, e.g. by adding icons to pages or providing a
feedback widget. While these features add value for the user of your site, they
2022-07-12 19:10:38 +03:00
shouldn't be necessary for previewing when making changes to content. Currently,
the only content-related features in Insiders that can't be properly previewed
by non-Insiders users are:
- [Annotations]
- [Card grids]
This means that outside collaborators are able to build the documentation
locally with Material for MkDocs and when they push their changes, your CI
pipeline will build it with Insiders. When using built-in plugins that are
exclusive to Insiders, it's recommended to split configuration into a base
`mkdocs.yml` and one with plugin overrides via [configuration inheritance].
2021-11-07 20:23:01 +03:00
See the [getting started guide] for more information.
2020-09-04 00:18:02 +03:00
2021-11-07 20:23:01 +03:00
[configuration inheritance]: https://www.mkdocs.org/user-guide/configuration/#configuration-inheritance
2021-11-07 20:59:18 +03:00
[getting started guide]: getting-started.md#caveats
2020-10-11 13:20:36 +03:00
2021-05-30 12:45:36 +03:00
### Payment
_We don't want to pay for sponsorship every month. Are there any other options?_
Yes. You can sponsor on a yearly basis by [switching your GitHub account to a
2021-11-07 20:23:01 +03:00
yearly billing cycle][billing cycle]. If for some reason you cannot do that, you
could also create a dedicated GitHub account with a yearly billing cycle, which
you only use for sponsoring (some sponsors already do that).
2021-05-30 12:45:36 +03:00
2021-11-07 20:23:01 +03:00
If you have any problems or further questions, please reach out to
sponsors@squidfunk.com.
2021-05-30 12:45:36 +03:00
2021-11-07 20:23:01 +03:00
[billing cycle]: https://docs.github.com/en/github/setting-up-and-managing-billing-and-payments-on-github/changing-the-duration-of-your-billing-cycle
2021-05-30 12:45:36 +03:00
2020-09-04 00:18:02 +03:00
### Terms
2021-11-07 20:23:01 +03:00
_Are we allowed to use Insiders under the same terms and conditions as
Material for MkDocs?_
2020-09-04 00:18:02 +03:00
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
2022-07-12 19:10:38 +03:00
by the [MIT license]. However, we kindly ask you to respect our
__fair use policy__:
2020-07-22 19:30:00 +03:00
2020-12-21 19:38:58 +03:00
- Please __don't distribute the source code__ of Insiders. You may freely use
2021-11-07 20:23:01 +03:00
it for public, private or commercial projects, privately fork or mirror it,
2023-09-15 10:25:50 +03:00
but please don't make the source code public, as it would counteract the
2021-11-07 20:23:01 +03:00
sponsorware strategy.
2020-07-22 19:30:00 +03:00
2021-11-07 20:23:01 +03:00
- If you cancel your subscription, you're automatically removed as a
collaborator and will miss out on all future updates of Insiders. However, you
may __use the latest version__ that's available to you __as long as you like__.
Just remember that [GitHub deletes private forks].
2020-07-22 19:30:00 +03:00
2021-11-07 20:23:01 +03:00
[MIT license]: ../license.md
[GitHub deletes private forks]: https://docs.github.com/en/github/setting-up-and-managing-your-github-user-account/removing-a-collaborator-from-a-personal-repository