Move to mkdocs #66
Merged
Move to mkdocs #66
Conversation
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Closed
EverVino
approved these changes
Nov 1, 2023
README.md
Outdated
|
|
||
| ```bash | ||
| brew install hugo | ||
| git clone [email protected]:osl-incubator/opensciencelabs.github.io |
There was a problem hiding this comment.
I guess we should change osl-incubator
There was a problem hiding this comment.
thanks for caching that. I am fixing that now. thanks!
| ```bash | ||
| cd osl-hugo.github.io | ||
| hugo server | ||
| makim pages.preview |
There was a problem hiding this comment.
This command is not working I used to start the preview mkdocs serve
There was a problem hiding this comment.
weird .. that is working here XD
I will take a look into that .. also it is not working something on CI
There was a problem hiding this comment.
@EverVino it seems it was installing python 3.12 and it was breaking the mkdocs command
|
@EverVino CI is working |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
hey @EverVino
I was thinking a bit, and maybe it would be better to move from hugo to mkdocs.
This is just an initial work , just to start a discussion and to check if it would be possible to make this migration.
Although hugo is very powerful, but I find the template language much more complex that it should be, also the experience for debugging is not that great.
For the other hand, mkdocs maybe it is not that powerful than mkdocs .. although it is very flexible and it is easy to create extensions.
the template here is the same used by hugo, so from the user experience, if we decide to change to mkdocs, there is no big impact.