mkdocs / mkdocs

Project documentation with Markdown.
https://www.mkdocs.org
BSD 2-Clause "Simplified" License
19.08k stars 2.4k forks source link

Reproducible Builds #2689

Closed parisni closed 9 months ago

parisni commented 2 years ago

So far, if one of the md file of my doc is modified, all the html files get modified, resulting in a large commit. Apprently the modification are essentialy random newlines.

Is there a way to avoid modifiyng every files when only in order not to flood commits when doc is modified ?

Thanks

timvink commented 2 years ago

This might be an issue with you git configuration. Are you on windows? Could be windows newlines being replaced by Unix newlines.

Also, you probably don't need to have generated artifacts like HTML under version control. You could .gitignore them as you can always rebuild them.

parisni commented 2 years ago

I'm on linux

In my use case, I publish the doc from master/docs folder.

On Thu Dec 9, 2021 at 12:30 AM CET, Tim Vink wrote:

This might be an issue with you git configuration. Are you on windows? Could be windows newlines being replaced by Unix newlines.

Also, you probably don't need to have generated artifacts like HTML under version control. You could .gitignore them as you can always rebuild them.

-- You are receiving this because you authored the thread. Reply to this email directly or view it on GitHub: https://github.com/mkdocs/mkdocs/issues/2689#issuecomment-989311380

oprypin commented 2 years ago

I haven't observed that this type of issue exists. I only saw that sitemap.xml.gz changes every time. So, you'd have to provide some particular site as a reproducible example. It could be a particular theme or plugin causing it. But I cannot guess it.

leonardehrenfried commented 1 year ago

@oprypin The changing of the sitemap.xml.gz is a little strange.

Is there a way to disable the generation of the gzipped sitemap?

oprypin commented 1 year ago

Yes

leonardehrenfried commented 1 year ago

And would you be so kind and tell me how? I cannot find anything on https://www.mkdocs.org/user-guide/configuration/