Live data from Hacker News

Zensical – A modern static site generator built by the Material for MkDocs team

squidfunk.github.io

11–20 of 64 posts

Re: Zensical – A modern static site generator built by the Material for MkDocs team

#11
the featured search engine is not typo-resistant, so unfortunately loses to google again, a bane of many sites. Wish search baseline finally caught up to the fact that humans can't type perfectly... (hopefully that's just because it's new and fresh, though)

Re: Zensical – A modern static site generator built by the Material for MkDocs team

#12

I was excited up until they showed what the new theme looks like. mkdocs-Material was nice in that it didn't have overly rounded corners and over travesties, a shame that custom CSS will be needed to undo the "modernisation". Overall this seems very interesting, especially the performance improvements, just a letdown visually.

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 the HTML is exactly the same right now. Most users favor the new look over the old one. [1]: https://zensical.org/docs/setup/basics/#theme-variant

> Most users favor the new look over the old one.

How do you know?

Re: Zensical – A modern static site generator built by the Material for MkDocs team

#13
post #12

Earlier quoted context omitted.

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 the HTML is exactly the same right now. Most users favor the new look over the old one. [1]: https://zensical.org/docs/setup/basics/#theme-variant

> Most users favor the new look over the old one. How do you know?

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.

Re: Zensical – A modern static site generator built by the Material for MkDocs team

#14
post #8

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 else's system as you did before. This would make new features and bug fixes more easy to be implemented. I am also very curious about what the MKDocs future would be like. Material has…

> 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 else's system as you did before. This would make new features and bug fixes more easy to be implemented.

Exactly this. We ran against walls trying to realize our ideas with MkDocs' APIs, so a rewrite was due. With MkDocs being unmaintained for over a year, we took the initiative. Since we have excellent product-market fit, investing into a new stack was just logical.

Re: Zensical – A modern static site generator built by the Material for MkDocs team

#15
post #11

the featured search engine is not typo-resistant, so unfortunately loses to google again, a bane of many sites. Wish search baseline finally caught up to the fact that humans can't type perfectly... (hopefully that's just because it's new and fresh, though)

We'll ship fuzzy search in the coming weeks. It's just awaiting a release.

Re: Zensical – A modern static site generator built by the Material for MkDocs team

#16
post #11

the featured search engine is not typo-resistant, so unfortunately loses to google again, a bane of many sites. Wish search baseline finally caught up to the fact that humans can't type perfectly... (hopefully that's just because it's new and fresh, though)

We'll ship fuzzy search in the coming weeks. It's just awaiting a release.

Nice!

Re: Zensical – A modern static site generator built by the Material for MkDocs team

#19

Hi, congrats on Zensical release. Want to ask is there any community space where people discuss ideas or what's being built? if not I'd be happy to help get something started for folks who want to learn and contribute.

We set up a Discord for the community, and have a dedicated space for professionals! https://zensical.org/docs/community/get-involved/

Re: Zensical – A modern static site generator built by the Material for MkDocs team

#20

The biggest issue I had with material for mkdocs was training BA type people to contribute. They had to muddle their way through python, pip, git, github, etc. just to make a one line change.

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, but we'll reach it eventually!
Post reply on HN