https://github.com/juke34/knowledge
My collection of cheat sheets / overviews / summaries and more
https://github.com/juke34/knowledge
bioinformatics cheat-sheets knowledge overviews summaries
Last synced: 3 months ago
JSON representation
My collection of cheat sheets / overviews / summaries and more
- Host: GitHub
- URL: https://github.com/juke34/knowledge
- Owner: Juke34
- License: cc-by-4.0
- Created: 2021-04-16T19:30:54.000Z (about 5 years ago)
- Default Branch: main
- Last Pushed: 2026-01-14T11:58:02.000Z (5 months ago)
- Last Synced: 2026-01-14T15:52:57.176Z (5 months ago)
- Topics: bioinformatics, cheat-sheets, knowledge, overviews, summaries
- Homepage: https://juke34.github.io/knowledge/
- Size: 10 MB
- Stars: 3
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[![CC BY 4.0][cc-by-shield]][cc-by]
# Jacques Dainat (Juke34) Gathered Knowledge
---------------------------
## Table of Contents
* [Foreword](#foreword)
* [Project layout](#project-layout)
* [For collaborators teachers and developers](#for-collaborators-teachers-and-developers)
* [Modify content](#modify-content)
* [MkDocs](#mkdocs)
* [Welcome to MkDocs](#welcome-to-mkdocs)
* [Installation](#installation)
* [Manual](#manual)
* [Conda](#conda)
* [Testing and building the website](#testing-and-building-the-website)
## Foreword
You can find here some of the knwoledge I have gathered duting my bioinformatician life.
The site itself lives [https://juke34.github.io/knowledge/](https://juke34.github.io/knowledge/),
where you can find all the relevant information.
## Project layout
```
README.md # General readme
mkdocs.yml # The configuration file for the site rendering.
conda_env.yml # Conda env to build and test the site locally
docs/ # material that will be publish with the static web site
index.md # The documentation homepage (Website Home page).
pages/ # Folder dedicated to a topic
images/ # Folder containing images related to the topic
xxx/ # Folder containing the .md files related to the topic topic
...
Images # Images used in the README
```
## For collaborators teachers and developers
This part is for collaborators-teachers and developers.
### Modify content
When you are in the repository, add and/or modify your markdown tutorials in the docs directory.
The arborescence of the website menu is to setup in the `mkdocs.yml` file
### Mkdocs
#### Welcome to MkDocs
For full documentation visit [mkdocs.org](https://www.mkdocs.org).
For full documentation about the [material mkdocs theme](https://squidfunk.github.io/mkdocs-material/).
#### Installation
##### Manual
As prerequisite you need python >=3.8 and pip.
Install Mkdocs:
`pip install mkdocs`
For the theme:
`pip install mkdocs-material`
For the extensions:
`pip install pymdown-extensions`
For the plugins:
`pip install mkdocs-minify-plugin`
`pip install mkdocs-macros-plugin`
`pip install mkdocs-include-markdown-plugin`
##### Conda
Clone the repository and move in it.
Then install all dependencies using conda and the `conda_env.yml` shipped with this repo:
```
conda env create -f conda_env.yml
```
Activate the environment and you are good:
```
conda activate education
```
#### Testing and building the website
* `mkdocs serve` - Start the live-reloading docs server, to test the site locally (http://127.0.0.1:8000/).
* `mkdocs gh-deploy` - Deploys the site on github pages.
* `mkdocs build` - Build the documentation site.
* `mkdocs new [dir-name]` - Create a new project.
* `mkdocs -h` - Print help message and exit.
[cc-by]: http://creativecommons.org/licenses/by/4.0/
[cc-by-shield]: https://img.shields.io/badge/License-CC%20BY%204.0-lightgrey.svg