No configuration seems to work
Closed this issue · 1 comments
In config.rb
we had:
configure :build do
set :http_prefix, '/data-community-tech-docs'
end
This works with bundle exec middleman server
, but with bundle exec middleman build
(which builds the site on GitHub Pages) it has no entries in the table of contents.
Removing it fixes the table of contents, but no CSS is found because it looks directly under alphagov.github.io instead of alphagov.github.io/data-community-tech-docs.
Setting activate :relative_assets
instead fixes both the table of contents and the CSS, but none of the links works because they then link to a page directly under alphagov.github.io instead of alphagov.github.io/data-community-tech-docs.
Eventually I found middleman/middleman#484 which led to alphagov/tech-docs-gem#291 which has been deployed and documented as https://tdt-documentation.london.cloudapps.digital/configure_project/global_configuration/#build-your-site-using-relative-links.