Sitemap doesn't get generated

[cloudlena]

As described here: /~https://github.com/pivotal-cf/bookbinder#generating-a-sitemap-for-google-search-indexing Bookbinder should create a sitemap.xml file. However, I cannot find this file after running bundle exec bookbinder bind remote on my book. Am I doing something wrong or is this a bug?

[cf-gitbot]

We have created an issue in Pivotal Tracker to manage this. Unfortunately, the Pivotal Tracker project is private so you may be unable to view the contents of the story.

The labels on this github issue will be updated when the story is started.

[animatedmax]

Hi @mastertinner This is a bug. Thanks for finding and reporting it!

[mogul]

Are there any updates about this issue?

[pspinrad]

FWIW, I don't know anything about that issue, but Bookbinder project is no longer active.

[cloudlena]

@pspinrad, what does that mean for the Cloud Foundry documentation? Will it be migrated to Hugo or a similar tool?

[pspinrad]

Hey @mastertinner -- Bookbinder still builds docs.cloudfoundry.org, but we are looking at alternatives. Have you used Hugo? Need something that can assemble content from many far-flung repos, pre-process Ruby (or other language) embeds to fill in context-dependent strings and handle simple logic, stuff like that. I gather that you also publish from the CF documentation repos, so would love to get your thoughts-- thanks!

[cloudlena]

@pspinrad, I am using Hugo and am very happy with it. To assemble content from multiple repos, you would, AFAIK, use Git submodules as the chapters of the "book". Out of the box, it doesn't do preprocessing with ERB or any similar tool like Bookbinder does but has many advanced features like variables and functions. It might be possible to have similar preprocessing to Bookbinder but getting rid of these ugly if ... else blocks we currently have in the CF documentation would be great anyways. So far I've tested Bookbinder, Hugo and GitBook and out of the three, Hugo is by far the most stable and mature one. I would definitely advise to use it.

[pspinrad]

@mastertinner this is great info, super helpful-- many thanks!

[mogul]

The cloud.gov team is also using Hugo. It would be a huge boon to us if you shifted from Bookbinder to Hugo!