Offline Tutorial

[txorav]

hello guys
i need an offline version of this tutorial if there is i would likr to have it and thank you

[bjorn3]

There are two options:

You could clone this repo and build it yourself. See

blog_os/.github/workflows/blog.yml

Lines 22 to 33 in 56ec24c

	- name: 'Download Zola'
	run: curl -sL https://github.com/getzola/zola/releases/download/v0.16.1/zola-v0.16.1-x86_64-unknown-linux-gnu.tar.gz | tar zxv
	- name: 'Install Python Libraries'
	run: python -m pip install --user -r requirements.txt
	working-directory: "blog"
	- name: "Run before_build.py script"
	run: python before_build.py
	working-directory: "blog"
	- name: "Build Site"
	run: ../zola build
	working-directory: "blog"

for the steps necessary for building it. You can then find the pages in blog/public.

Alternatively you can take the official build from CI. For example as of writing this https://github.com/phil-opp/blog_os/actions/runs/3274928653 is the last CI run. In the artifacts section there is the generated_site artifact which is a zip file containing the entire site.

[mcandre]

Second this feature request, as a way to grow readership.

I don't imagine the ZIP is an ePUB, right? Just a siterip, requiring a full Web browser.

What if we received the articles as a Git Book, which would provide a server generated offline ebook, in suitable formats for popular ereader applications?

[phil-opp]

Yes, the zip is the website in HTML format, so you need a web browser to view it.

Unfortunately, we don't have EPUB support right now (see also #1070). I think it should be possible to use calibre and its ebook-convert CLI tool to create a book from the HTML website, but we probably need to do some layout adjustments before doing the conversion.

Switching to GitBook is not planned because I like to keep the blog format.