squidfunk

9 ms·

1.
by squidfunk 6mo ago
Creator of Zensical here! Would you mind sharing a bit more detail on why you feel the comparison is on point? One of our core goals with Zensical is to simplify things – not add complexity. We’re also working toward making it an almost 100
2.
Material for MkDocs Insiders – Now free for everyone(squidfunk.github.io)
2 points by squidfunk 10mo ago|0 comments
3.
by squidfunk 10mo ago
Zensical team here. Yes, there are very good reasons for that change. First and foremost, with MkDocs using YAML, and Material for MkDocs being the main entrypoint for many of our users, we got a lot of issues with users having trouble just
4.
by squidfunk 10mo ago
Coming from Material for MkDocs, right now, sources need to be in Markdown files. However, our new build system is extremely flexible, so with the upcoming module system, it will be possible to add further sources and integrate them into th
5.
by squidfunk 10mo ago
Zensical team here. It's perfectly usable – we're of course building our own docs with it and the first users have already switched – but you have to have an eye on compatibility. Whether you can switch right now largely depends o
6.
by squidfunk 10mo ago
Zensical team here – right now it's still Python/Pygments under the hood, as we're using the same toolchain for rendering for compatibility reasons, but we'll be rethinking language support from the ground up, and tree s
7.
by squidfunk 10mo ago
Excellent question. We're not using differential dataflow (DD), but are rolling our own differential runtime. It's basically functions stitched together with operators, heavily inspired by DD and RxJS, and is optimized for perform
8.
by squidfunk 10mo ago
Zensical Spark is our offering for professional users. In the past 12 months, we've had numerous conversations with organizations and enterprises to understand how they adapted Material for MkDocs to their processes and workflows. Our
9.
by squidfunk 10mo ago
It's definitely not malicious intent. It's an inlined version of our new search engine that we'll release in early 2026, but already wanted to ship with Zensical. However, you're right that this might raise some eyebrows
10.
by squidfunk 10mo ago
We'll do our best! The author of mkdocstrings[1] (the leading API reference docs solution in the MkDocs space) is part of our team, so we're aiming to bring much more powerful API reference docs support to Zensical. [1]: mkdocstri
11.
by squidfunk 10mo ago
Yes, we're basically agnostic to the input and output formats. Right now it's Markdown -> HTML, but with the upcoming module system, it'll be possible to convert anything to anything. Our focus will stay Markdown/HTML
12.
by squidfunk 10mo ago
We've heard this many times when talking to our enterprise users, which is one of the reasons that motivated the fresh start. WYSIWYG is on our roadmap as a stretch goal, allowing non-tech users to contribute. It'll take some time
13.
by squidfunk 10mo ago
We set up a Discord for the community, and have a dedicated space for professionals! https://zensical.org/docs/community/get-involved/
14.
by squidfunk 10mo ago
We'll ship fuzzy search in the coming weeks. It's just awaiting a release.
15.
by squidfunk 10mo ago
> It is a very reasonable choice: your plug-in project has grown to a scale you have never anticipated. Therefore, you built your own system from the ground up, one which you have total control over, instead of keeping to rely on someone
16.
by squidfunk 10mo ago
From the feedback we got after launching. More accurately: most users that we conversed with since launch are very happy about the new look. Regardless, for compatibility reasons, the old look is available as well.
17.
by squidfunk 10mo ago
Creator of Zensical here! As always, it's a matter of taste. We felt the original look was a little date. You can use the classic Material for MkDocs look with Zensical by adding a single line of configuration[1]. This works because th
18.
by squidfunk 2y ago
Hey there, maintainer of Material for MkDocs here! MkDocs has quite a history, which is why we theme, plugin and extension authors are working very hard to put MkDocs on a solid foundation, and to build an inclusive and welcoming team that
19.
by squidfunk 3y ago
Author here. What specifically don't you like about the blog plugin? We'd love to improve it with user feedback and make it even more powerful!
20.
by squidfunk 3y ago
Author of Material for MkDocs here. We're currently working on re-architecting the entire search engine and rewriting it from scratch. We're currently based on lunr.js, which is unmaintained as of 2020 and has more or less run its
21.
GitHub eradicated –$240k/m in sponsorships in 28d(twitter.com)
3 points by squidfunk 3y ago|0 comments
22.
by squidfunk 4y ago
Author of Material for MkDocs here. I totally understand that some people don't like Material Design, as it's just everywhere nowadays and can be considered a bit overused. However, with little effort, you can adjust the style of
23.
by squidfunk 4y ago
Maintainer of Material for MkDocs here. Correct! The Sponsorware strategy is an alternative to dual-licensing which works fairly well for our project. If you have a successful Open Source project that is a pain killer and product-market fit
24.
My Open Source project hit $100k/year(twitter.com)
3 points by squidfunk 4y ago|0 comments
25.
You can now build a blog with Material for MkDocs(squidfunk.github.io)
1 points by squidfunk 4y ago|0 comments
26.
by squidfunk 4y ago
I recommend checking the list of OpenSource projects that use Material for MkDocs [1], for example FastAPI [2]. Alternatively, you can clone the Material for MkDocs repository, as the docs are built with itself. [1] https://gith
27.
by squidfunk 4y ago
Jup, MathJax is supported with minimal setup: https://squidfunk.github.io/mkdocs-material/reference/mathja...
28.
by squidfunk 4y ago
Author of Material for MkDocs here. MkDocstrings [1] implements automatic generation of reference documentation from sources. It's language-agnostic, actively maintained and currently supports Python [2] and Crystal [3]. It also integr
29.
by squidfunk 5y ago
Thanks for your continued support!
30.
by squidfunk 5y ago
The README has some links to installations used by open source projects and companies, see my other comment [1]. [1]: https://news.ycombinator.com/item?id=27301712

More ›