Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Consider moving to mdbook #3

Closed
shilangyu opened this issue Mar 1, 2020 · 1 comment
Closed

Consider moving to mdbook #3

shilangyu opened this issue Mar 1, 2020 · 1 comment

Comments

@shilangyu
Copy link
Owner

shilangyu commented Mar 1, 2020 •
edited
Loading

Based on gitbook, mdbook is a configurable rust books generator.

mdbook

➕ ➖
very fast build times much less lightweight
while abstracting many things away it maintains very high configurability uses mathjax
sweet sweet search bar weird syntax for TeX blocks
preprocessors
easy bootstrapping
has ready themes

pandoc

➕ ➖
personal touch everything is done from scratch so new features require time to implement
katex is fast and pre-renderable uglier design
100% configurability

Main things holding me off: losing the personal touch, slow mathjax, and retarded TeX blocks

Mathjax could be replaced with katex with some tinkering and TeX blocks could be replaced with preprocessors (which is just as stupid)

mdbook has an open issue about katex
@shilangyu shilangyu changed the title Consider moving to mdbook Consider moving to mdbook. Oct 9, 2020
@shilangyu shilangyu changed the title Consider moving to mdbook. Consider moving to mdbook Oct 9, 2020
@shilangyu
Copy link
Owner Author

personal touch

This wins.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Assignees
No one assigned
Labels
None yet
Projects
None yet
Milestone
No milestone
Development

No branches or pull requests
1 participant
@shilangyu