+
Your static site is ready
+
+
+ Rendered <%= pluralize(@result.books, "book") %>,
+ <%= pluralize(@result.leaves, "page") %>,
+ <%= pluralize(@result.assets, "asset file") %>, and
+ <%= pluralize(@result.resources, "image") %>
+ (<%= @result.bytes %>).
+ <% if @result.resource_failures.to_i.positive? %>
+ <%= @result.resource_failures %> image(s) could not be copied — see the server log.
+ <% end %>
+
+
+ <%= button_to static_export_path, method: :post, class: "btn btn--reversed center txt-medium" do %>
+ <%= image_tag "refresh.svg", aria: { hidden: true }, size: 24 %>
+
Generate again
+ <% end %>
+
+
+
Where it is
+
+ On this server: <%= @output_dir %>
+
+
+
+
+
Preview locally
+
cd <%= @output_dir %>
+python3 -m http.server 8080
+
Then open http://localhost:8080.
+
+
+
+
Deploy it
+
+ Copy the contents of that directory to any static host — Netlify,
+ Cloudflare Pages, GitHub Pages, an S3 bucket, or your own nginx. URLs are
+ root-relative, so the site works at any domain's root with no extra config.
+
+
+
+
+
Including drafts, or very large libraries
+
+ Only published books are exported here. To include unpublished drafts, or to
+ export without holding a web request open, run
+ bin/rails static:generate STATIC_ALL=1 from the server shell —
+ it leaves your live database untouched.
+
+
+
+
Export to a static site
+
+
+ Generate a self-contained HTML version of your published library — the menu of
+ books, every book's table of contents, and every page — with all CSS, JavaScript,
+ and image files copied in. No Rails process, login, or editing machinery: the
+ result can be hosted anywhere.
+
+
+ <%= button_to static_export_path, method: :post, class: "btn btn--reversed center txt-medium" do %>
+ <%= image_tag "download.svg", aria: { hidden: true }, size: 24 %>
+
Generate static site
+ <% end %>
+
+
Only published books are included.
+
+ To include unpublished drafts as well, run
+ bin/rails static:generate STATIC_ALL=1 from the server shell — it
+ leaves your live database untouched.
+
+
+ For very large libraries, prefer that rake task too: it avoids holding a single
+ web request open while the whole library renders.
+
+