jimporter / mike

Manage multiple versions of your MkDocs-powered documentation via Git
BSD 3-Clause "New" or "Revised" License
547 stars 47 forks source link

Version a subdirectory of the site? #158

Closed sdruskat closed 1 year ago

sdruskat commented 1 year ago

Hi, and thanks for this helpful tool.

Making my first steps using mkdocs, Material for MkDocs, and mike.

I'm wondering if the following is possible, which I think isn't covered by --prefix?

I can think of a hack where the versioned content lives in another repo which is hardlinked to from the non-versioned content (e.g., from an org-level GH Pages), but was wondering if this is (or potentially can be) supported "natively" by mike.

jimporter commented 1 year ago

That's probably possible with --prefix if you also create a safe way of separately deploying your unversioned docs as a different MkDocs deployment. However, I'd recommend just versioning everything; it's simpler that way.

sdruskat commented 1 year ago

Thanks, you're right, it's easier to version everything.