practicalli 2022-12-02

Practicalli books are going to shift to some new tooling over the coming days, hopefully without too much interruption. I'll be starting with http://Practical.li/neovim today I've been using GitBook for many many years, long after it was no longer supported and the plugins I use break after node.js version 11. GitBook is therefore a challenge to run locally and it is really very slow on the larger books (a couple of minutes locally and about 10 minutes via GitHub actions workflow

I will also be greatly improved the styling of the book web pages, whilst keeping and enhancing the functionality. There will also be a more obvious light/dark theme toggle and general more friendly to use.

I'll write a blog post about the new tool I am using, mkdocs, including how I set it all up soon, in case anyone is thinking of creating their own tech docs /online books

That's awesome! Thank you so much for all of your hard work on this

➕ 1

A sneak peak at the new neovim website at: https://practicalli-john.github.io/neovim-mkdocs/ This is only a test site and the real site will still be at the exiting URL Take a look at the https://practicalli-john.github.io/neovim-mkdocs/writing-tips/ for examples of all the nice things I can now do with the books

Clean and snappy!

👍 1

Thanks. There are some markup differences, so a few things might not quite be ready and require a tweak in this book, probably many more tweaks in the larger books, but definitely worth the extra work.

The new version of Practically Neovim site is live https://practical.li/neovim/ I'll be working on the Spacemacs site next

🎉 1