Add back documentation for offline build

[lambtho12]

Prerequisites

• [X] I have searched for duplicate or closed feature requests
• [X] I am mindful of the project scope

Proposal

It looks like the doc for building an offline-site was not migrated when rebranding to Hugo Blox.

Would it be possible to add it back?

Motivation and context

Building an website that is self-contained and does not call to various external sources is important for privacy-minded people. The small documentation on how to build an offline website for Wowchemy already existed, adding it back should not add lots of work while providing valuable information for the ones interested.

[gcushen]

There are no offline docs for the Tailwind-styled version of Hugo Blox as it's now entirely offline by default (those measures are builtin) so those docs are no longer appropriate.

If you're using the Boostrap version, you can find the Bootstrap docs here: https://bootstrap.hugoblox.com

[lambtho12]

The website is still not offline and still calls numerous services (CDNs) to get everything.

What I do:

1. Get clean version of the template git clone https://github.com/HugoBlox/theme-academic-cv.git
2. Get dependencies hugo mod vendor
3. Run server with hugo server

When I check the network tool, I get calls to

• cloudflare.net
• fastly.net
• gstatic.com
• jsdelivr.net
• openstreetmap.org

With the old method, it was possible to make a local copy of everything so none of these were called. I would like to replicate it with the new version. So I do not really understand your "it is offline by default". Could you explain a bit more?

[lambtho12]

@gcushen , could you explain why/how the base website makes these calls and how to avoid it so everything is served from my server rather than fetched form external sources?

[gcushen]

@gcushen , could you explain why/how the base website makes these calls and how to avoid it so everything is served from my server rather than fetched form external sources?

I'm not the sole contributor on the project, there are 200 others, some of whom contributed to these features. Third party integrations were generally integrated based on the instructions from those third parties. For example, how do you intend to display a third party map without letting the user download the map from the third party? Does open street map have such an offline feature?

My previous comment on having an offline site by default was referring to the new Tailwind-styled templates such as the Resume template.

[lambtho12]

Obviously, some of the external resources are easy to disable. As you point, I just have to disable the map to get rid of openstreetmap... But for gstatic, or jsdelivr it is not that obvious. I would rather simply have all js or css hosted locally, that is it.

My previous comment on having an offline site by default was referring to the new Tailwind-styled templates such as the Resume template.

I plan to use academic-cv.