search

pivotal-cf / bookbinder

A command line utility for stitching modular Markdown docs into into a unified, hostable web-app.
Apache License 2.0
45 stars 49 forks source link

Sitemap doesn't get generated #111

Open cloudlena opened 8 years ago

cloudlena commented 8 years ago

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 commented 8 years ago

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 commented 8 years ago

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

mogul commented 6 years ago

Are there any updates about this issue?

pspinrad commented 6 years ago

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

cloudlena commented 6 years ago

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

pspinrad commented 6 years ago

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 commented 6 years ago

@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 commented 6 years ago

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

mogul commented 6 years ago

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