mirror of
https://gitlab.waag.org/make/fablab/interns/2025/sam.git
synced 2025-08-03 20:04:56 +00:00
customsation mkdocs docs
This commit is contained in:
@@ -23,3 +23,7 @@ Once you run that it outputs a key. That key is your public ssh key. You can sha
|
||||
|
||||
Now you can register the key that got output in the console on the gitlab server. First click your profile picture in gitlab and then go to edit profile. Now you have a menu bar on the left, there you can click the SSH Keys tab and register your ssh key. After you have done that you can push and pull from your gitlab repository.
|
||||
|
||||
## Cloning the repository
|
||||
To clone a git repository you need a link to the repository. How
|
||||
|
||||
TODO: finish this
|
44
docs/week1_fabacademy/customising-mkdocs.md
Normal file
44
docs/week1_fabacademy/customising-mkdocs.md
Normal file
@@ -0,0 +1,44 @@
|
||||
# Customising mkdocs
|
||||
|
||||
I wanna customise my mkdocs theme. So I can have a dark mode. Because it currently looks like this.
|
||||
|
||||

|
||||
|
||||
|
||||
## Issues
|
||||
|
||||
### Attempt 1
|
||||
I tried changing it by referencing extra css but when it builded i looked through the job artifacts and I saw that it didnt pick up on the file
|
||||
|
||||
```yml
|
||||
site_name: Fab Academy docs page - Sam
|
||||
site_url: https://pages.gitlab.io/mkdocs
|
||||
site_dir: public
|
||||
theme:
|
||||
name: ivory
|
||||
extra_css: [extra.css]
|
||||
```
|
||||
```css
|
||||
.footer-note {
|
||||
color:rgb(47, 44, 44) !important
|
||||
}
|
||||
|
||||
.home .version {
|
||||
color:rgb(47, 44, 44) !important
|
||||
}
|
||||
```
|
||||
### Attempt 2
|
||||
After I read the documentation thoroughly i found out that the css file needs to be relative to the `docs` folder and not the `mkdocs.yml`. After that it showed the css and I could finaly customise the theme.
|
||||
|
||||

|
||||
|
||||
## Customising Material theme
|
||||
I decided to switch to material theme because its easier to configure and you can add all sorts of modules onto it making it super customisable.
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
### Links
|
||||
* https://squidfunk.github.io/mkdocs-material/setup/extensions/python-markdown/#table-of-contents
|
||||
* https://squidfunk.github.io/mkdocs-material/setup/setting-up-navigation/#table-of-contents
|
Reference in New Issue
Block a user