You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Was thinking about this for a relatively long time and #2923 kind of reminded me of it again.
The idea is to implement some sort of system Symilar to that of Jekyll that would allow the download and usage of an external theme not bundled with MkDocs.
It could be similar to how Jekyll does it, by defining a @user/repository combination as the theme for MkDocs to recognize and use.
Benefits are that the user doesn't need to first download the theme before having to define it (And it could perhaps even allow to use forks or specific versions/commits for testing or similar).
Downsides are that it may be a bit more difficult for more advanced themes, such as Material for MkDocs, which also bundles extensions with itself (And MkDocs itself) on download, so maybe some configuration option within the repository could be used to determine what the theme does during download.
Whether the theme should be downloaded permanently or only temporary while using MkDocs (or building the pages) is something I would leave up to the devs here.
If anything, is this a "nice to have" feature, so I would understand if it can't or won't be implemented for any reasons.
reacted with thumbs up emoji reacted with thumbs down emoji reacted with laugh emoji reacted with hooray emoji reacted with confused emoji reacted with heart emoji reacted with rocket emoji reacted with eyes emoji
-
Was thinking about this for a relatively long time and #2923 kind of reminded me of it again.
The idea is to implement some sort of system Symilar to that of Jekyll that would allow the download and usage of an external theme not bundled with MkDocs.
It could be similar to how Jekyll does it, by defining a
@user/repository
combination as the theme for MkDocs to recognize and use.Benefits are that the user doesn't need to first download the theme before having to define it (And it could perhaps even allow to use forks or specific versions/commits for testing or similar).
Downsides are that it may be a bit more difficult for more advanced themes, such as Material for MkDocs, which also bundles extensions with itself (And MkDocs itself) on download, so maybe some configuration option within the repository could be used to determine what the theme does during download.
Whether the theme should be downloaded permanently or only temporary while using MkDocs (or building the pages) is something I would leave up to the devs here.
If anything, is this a "nice to have" feature, so I would understand if it can't or won't be implemented for any reasons.
Beta Was this translation helpful? Give feedback.
All reactions