One More Thing
I have been bitching about hugo and antora in my last post. Actually there is one more thing.
It is not as powerful as hugo. It cannot even be considered as a full fledged package. It is just a wrapper around the mdbook crate. The biggest pro is tight integration with Rust. All documentation including about Rust, for example, the book, is generated by mdbook. Another good example is neovide website.
neovide (github) is an interesting project that enlightens me in may ways.
Firstly, it is GUI client of neovim, my favorite editor. So what exactly the fuck is a GUI for a text, well terminal, based editor? It has a built-in terminal, so have a wrapper is not impossible. So after some googling, it about its UI protocol. There is another blog post describing it. An editor has a protocol. That is cool and enticing. The first thing to do is browsing the neovide repo. The main.rs documents the framework of it. That is interesting. It could be a very good starting point for me to learn Rust.
After browsing the repo for a while, I have noted that it is essentially a cargo new hello-world --bin project. But within it, there is a website directory created by mdbook init hello-world. There is one github actions that builds it. This approach of organizing source code and documentation is exactly what I am looking for as I want to document my own Rust learning progressions.
After a further look at the structure of the code, i decided to create a similar github page despite I have not yet completely understood the details of the code. The result is crab and its corresponding website. The main objective of this repo and the web site is to keep track of my rust learning progression. So please expect shit happens and/or stepped on.
As of today 23-09-2022, the site is not very exiting. It is just up and running as yet another github pages.
Well, let’s see how it goes.