Here are some frequently asked questions about Tome:
- "Why was Tome made?"
Tome was and is a hobby project that was created as a response to extremely complex Drupal sites and relatively complex static site generators. If a Drupal site can be static, it should be, and that's why Tome exists.
- "How is Tome different than wget --recursive?"
- wget cannot determine what pages have been changed, deleted, or added since the last run. Tome uses Drupal cache tags to filter out paths that should not be generated, which (if cache is "warm"), makes it faster than wget.
- wget requires an HTTP server to run. Tome uses internal Drupal requests to generate HTML, which has a few benefits:
- Multiple pages can be generated in one Drupal bootstrap. This is a performance boost that can have some interesting side-effects (see \Drupal\tome_static\RequestPreparer), but is efficient.
- You can generate pages for another HTTP host by simply passing "--uri" or inputting one in the user interface. Usually the hostname you're using Drupal on is not going to be the same as the one you host HTML on, so this is a common need.
- You can generate HTML on a CI environment without configuring a web server. This is done today on Netlify at https://github.com/drupal-tome/netlify-template.
- wget cannot make concurrent requests. Tome can! Not much more to say there.
- Tome converts Views pagers to work on static hosting, by converting URLs like /my-view?page=1 to /my-view/page/1. Media oEmbed URLs are also converted. This would be really difficult with wget.
- Tome copies static assets (CSS, JS, images) with a file copy instead of an HTTP request. This is faster than a new HTTP request with wget.
- "Can you really rebuild a Drupal site from scratch?"
- "Are you building a Tome product?"
- "Do you want to?"
Probably not, but let me know if you have a convincing argument! I think the audience for Tome is really specific (small), and the whole point is to be able to use Drupal for free, with no worries about maintenance cost or risk. If a Tome product existed it would have to be so low cost that it may not be worth my time to build. If you're reading this and want to build a Tome product, I'd be happy to talk about a donation model to support the project.
- "Who is paying for Tome?"
No one, it's just free software.
- "Does anyone use Tome in production?"
Yes, mostly personal blogs and some enterprise users. Here are some sites I know of:
- https://tome.fyi/ (duh)