Here's a video showing how it'll work with collapsible Admonitions: https://twitter.com/squidfunk/status/1328243288785235975
Im really hoping some companies will chim in. The growth rate is good at the moment, but mainly $10 sponsors. Currently 40 in total.
Somebody made a Gource animation of Material for MkDocs! 7000 icons coming in @5:00 https://www.youtube.com/watch?v=ZAMGVj_pvk4&ab_channel=Gourcer
hi guys! have you ever tried to solve the problem with cached css and js contents? I've deployed a new script but it works only after all saved browser files are deleted. can I force css and js files update on the mkdocs-material side? I want to try to solve the problem on my side without changing the deployment configuration
If so, the probably easiest thing you can try is using query-string based cached busting: https://css-tricks.com/strategies-for-cache-busting-css/#query-strings – albeit it's not a best practice, it's easier to implement than chunk hashes, which demand a build process.
found some more search oddities, inserted "MoveTo" into a few more documents, search finds it but the preview does not show it
Better search summaries are already on the roadmap: https://squidfunk.github.io/mkdocs-material/insiders/#biquinho-vermelho – it's something I wanted to do before, but it's far from easy to solve this for all of the 40 languages. However, it will definitely be addressed in the next months.
it gives the impression that it does not find the searched for term at all currently
Try searching for "awesome" on the Insiders docs and just press ENTER, it'll highlight the result in the text: https://squidfunk.github.io/mkdocs-material-insiders/deprecations/?h=+awesome#bundled-plugins
Try it out with the mkdocs-encryptcontent-plugin, https://github.com/CoinK0in/mkdocs-encryptcontent-plugin
Thank you, but I cannot render the latex code when using this plugin.
MkDocs uses Markdown, not LaTeX. If you want to parse LaTeX in Markdown, you need some kind of extension that can parse LaTeX inside Markdown, or at least preserve the LaTeX from being treated as Markdown and use a JavaScript Library to parse it afterwards. The latter is how most known Markdown extensions handle LaTeX math. Material’s documentation covers this here: https://squidfunk.github.io/mkdocs-material/reference/mathjax/. And the extension it references gives even more details in its own documentation: https://facelessuser.github.io/pymdown-extensions/extensions/arithmatex/.
can someone explain to me in which situation this line of code kicks in?
https://github.com/squidfunk/mkdocs-material/blob/86a4c47c0a/material/partials/nav-item.html#L38
https://github.com/squidfunk/mkdocs-material/blob/86a4c47c0a/material/partials/nav-item.html#L38
i'm now determined to implement clickable links.
still no idea why it wasn't added.
mkdocs/mkdocs#1042
https://gitter.im/squidfunk/mkdocs-material?at=5f8770e93775d02b5a0e8178
still no idea why it wasn't added.
mkdocs/mkdocs#1042
https://gitter.im/squidfunk/mkdocs-material?at=5f8770e93775d02b5a0e8178
even with that, i wasn't satisfied with how much of the pre-existing html i needed to duplicate. that'd go stale quick
but the main point is, this template modification is just the smaller half of this. the important part is it introduces a "protocol" into the nav that themes could agree to cooperate on, i.e. just apply this modification upstream; it's backwards-compatible
I'll follow up on this later and send requests to theme owners. if they don't want, i can just keep maintaining a hack for that theme
There was quite a disussion in some issue (haven't looked yet) some time ago regarding this topic. Personally, I don't think the plugin approach will be resilient enough, as the HTML is subject so changes (sometimes), and some people are even still stuck on Material 4. Thus, it's better to integrate it with the themes, as you already suggested. However, I think that this should be solved at the template level. However, I don't know whether MkDocs currently supports this. There's a rather old issue which might have gone stale: mkdocs/mkdocs#1042
We could move this topic forward, if there's a native way of defining section-level pages (mabe just call them
index.md?) However, given the significant time investment this bears, as Material has so many navigation options all of which still would need to work, I would consider this being an Insiders feature. If there actually is a way to do it (mostly) natively with MkDocs without the support of a plugin, we can discuss stuff in an issue over after the Material for MkDocs repository.
Ok, turns out, it's possible (I was too curious). You can just add an
index.md page in a folder and MkDocs will treat it as an index.html file of that folder. Thus, content could be added to sections. The only thing that needs to be checked is how to list those pages out in the navigation. Maybe we would need to define a special title that is treated as "don't include in nav".
the current idea is to just rely on the user to specify the titles of all items in the nav and intentionally omit the title of the first item of a section