flatpak / flatpak-docs

Flatpak documentation
https://docs.flatpak.org
Other
78 stars 133 forks source link

Command references have duplicated headers #436

Closed TingPing closed 3 months ago

TingPing commented 8 months ago

These are generated files from the other projects, so we will need to either change the generation or just manually filter out the headers.

razzeee commented 8 months ago

This is not an automated process is it? Do we know how/who creates the files? Any docs?

TingPing commented 8 months ago

It is all manual. If you build flatpak and flatpak-builder with -Ddocbook_docs=enabled and -Ddocs=enabled respectively they will output the HTML file that gets copied here.

The input template is here: https://github.com/flatpak/flatpak/blob/main/doc/flatpak-docs.xml.in

That said we probably don't want to change the template, maybe a simple import script here that strips it would be a reasonable idea.