Conversation
pinkforest@hachyderm.io

pinkforest(she/her) 🦀

I'm doing a documentation site or "book" for my io-uring abstractions. I wonder if mdbook is adequate or should I try something else? It contains both code and images how to use them. Want it pretty with as little effort as possible ✨

2
0
0
pinkforest@hachyderm.io

pinkforest(she/her) 🦀

Reply to @jarkko

@jarkko damn that looks nice and batteries included with community. thanks!

1
0
1
jarkko

Jarkko Sakkinen

Reply to @pinkforest@hachyderm.io
Edited 1 month ago
@pinkforest It's like "LaTeX for engineers"

Word is for managers, LaTeX is for scientists and there has been an empty "for Engineers" slot to fill up until Typst came out :-)

It also has Beamer alike package called Polylux: https://github.com/polylux-typ/polylux

For me this was love at first sight at least.
1
0
1
pinkforest@hachyderm.io

pinkforest(she/her) 🦀

Reply to

@Kijewski Thanks! Will try that out too. Think I might go maybe with typst Jarkko pointed out given it's 🦀 as I am based :) Will see how they compare.

1
0
1
pinkforest@hachyderm.io

pinkforest(she/her) 🦀

Reply to @jarkko

@jarkko yeah it sure beats injecting KaTeX js on places where XSS comes as a feature 😬 It seems to offer some great visualization aids too which is 🙆‍♀️

0
0
1
jarkko

Jarkko Sakkinen

Reply to @pinkforest@hachyderm.io
@pinkforest @Kijewski My Rust "hate feedback" when it comes to kernel has been lately like:

1. "even if it is Rust we love also first in class commit messages"
2. "even if it is Rust I still need to be able to test this, not just compile"

I love Rust too but I still also love the best practices if of the ancient era :-) I commit to yelling on these until they start to be the status quo... It's called governance 🕶
0
0
1
wffl@im-in.space

waffle

Reply to @pinkforest@hachyderm.io

@pinkforest mdbook is just alright. doesn't really look beautiful imo, but it does the job and is easy to use

1
0
0
pinkforest@hachyderm.io

pinkforest(she/her) 🦀

Reply to @wffl@im-in.space

@wffl yeah went with mdbook given it's got first-class citizen HTML render whilst typst HTML render seems experimental and more oriented for formal papers e.g. pdf

0
0
0
About social.kernel.org

Terms of service

  1. Please do not use this service in violation of the Linux Kernel Code of Conduct. Doing so will result in your account suspension with the referral of the matter to the CoC committee.

  2. "Repeating"/"boosting" someone else's status on this platform will be treated as endorsement and will fall under rule #1.

  3. You are encouraged to use this platform to promote your work on the Linux Kernel, but there is no restriction on permitted topics (with the exception of anything covered by #1 above).

  4. There is no requirement to post in English, but it should be considered the primary language of communication on this platform.

Privacy notice

The admins of this service have access to all posted statuses. They aren't looking, but if it's something they shouldn't know about, then you should not post it on this platform.

Please see the Linux Foundation Privacy Policy, which applies to this platform as well.

Getting your own account

If you would like an account on this instance, please check that the following applies to you:

  • You are listed in MAINTAINERS or CREDITS

  • OR: You have a kernel.org account or email address

  • OR: You have a long and established history of involvement with the Linux Kernel

If the above is true and you agree with the Terms of Service and Privacy Notice listed above, please use these instructions to request an account: