search

dwyl / book

📗 Our Book on Full-Stack Web Application Development covering User Experience (UX) Design, Mobile/Offline/Security First, Progressive Enhancement, Continuous Integration/Deployment, Testing (UX/TDD/BDD), Performance-Driven-Development and much more!
https://dwyl.github.io/book/
818 stars 132 forks source link

`mdBook` 📗 😍 #91

Closed nelsonic closed 1 year ago

nelsonic commented 1 year ago

The tool that is used to make the Rust Book: https://doc.rust-lang.org/book is mdBook: https://github.com/rust-lang/mdBook image

Going to try and use it now on localhost. 👨‍💻 ⏳

nelsonic commented 1 year ago

https://rust-lang.github.io/mdBook/guide/installation.html https://rust-lang.github.io/mdBook/guide/creating.html

nelsonic commented 1 year ago

Test-driving Native Markdown Editor: https://github.com/nelsonic/amemo/issues/60 for distraction free writing ... ✍️

nelsonic commented 1 year ago

Publishing mdBook on Github Pages: https://users.rust-lang.org/t/publishing-mdbook-on-github-page/75132 -> https://github.com/rust-lang/mdBook/wiki/Automated-Deployment%3A-GitHub-Actions

nelsonic commented 1 year ago

Testing out: https://github.com/rust-lang/mdBook/wiki/Automated-Deployment%3A-GitHub-Actions#jamesivesgithub-pages-deploy-action 🤞

nelsonic commented 1 year ago

Trying to customise the <head> to include plausible/analytics: https://github.com/dwyl/technology-stack/issues/127 Reading: https://rust-lang.github.io/mdBook/format/theme/index.html

nelsonic commented 1 year ago

Created: https://github.com/dwyl/book/blob/main/theme/head.hbs https://github.com/dwyl/book/blob/b42d3ea329c674fd148abcea12526de614e41435/theme/head.hbs#L1

But doesn't seem to be included in the latest build of: https://dwyl.github.io/book Need to make time to investigate this. But have to get back to my "work work" now ... ⌛

nelsonic commented 1 year ago

https://plausible.io/dwyl.github.io?page=%2Fbook%2F

image

😉

nelsonic commented 1 year ago

Confident that this will be a good way forward. Closing. ✅