# How to make a gitbook

## Methodology

* Create an account on [gitboook.com](https://www.gitbook.com/)
* Synchronize you account with github using the instructions on [this blog by Thomas Suedbroecker](https://suedbroecker.net/2020/05/14/get-started-with-gitbook-and-github-a-small-guide/) that explains the whole process really clearly :D
* What is great is that if you are not ready to publish it yet it can stay private and you can make it public afterwards. For this you just need to keep the github repo private and your gitbook page connected to it private as well.
* In order to organize the pages as you please you can add this yaml and name it `.gitbook.yaml` and put it in the root of your repo on github.

```yaml
root: ./

structure:  
    readme: README.md  
    summary: SUMMARY.md
```

* So now you can add every new page in your summary to appear. Check out my summary [here](https://github.com/CSbyGB/pentips/blob/main/SUMMARY.md) to get an idea on a structure you can have for your gitbook.
* As you can see on my summary every `## Tile` makes a title and\
  `* [page](networking/basics.md)` makes a page inside it.\
  So this

  ```md
  ## Networking
  * [Basics](networking/basics.md)
  ```

  Shows up like this on my gitbook in the side bar\
  ![example](https://1679624655-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEkk28J0B2BeDMuesRMr1%2Fuploads%2Fgit-blob-7d46308c35ee1a060bd90df0d9a74453aaa6bd6e%2F2022-10-18-09-06-13.png?alt=media)
* If you want to put embedded resources instead of just clickable text you can use this code snippet

![snippet](https://1679624655-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEkk28J0B2BeDMuesRMr1%2Fuploads%2Fgit-blob-24d10b7ed5540d616da7945906ab71cede9e4a43%2F2022-10-19-15-02-14.png?alt=media)

* So for example this

![example snippet](https://1679624655-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEkk28J0B2BeDMuesRMr1%2Fuploads%2Fgit-blob-4b06806a06553c168fb5c3d081f058e36ad44db5%2F2022-10-19-15-15-02.png?alt=media)

Will look like this on your Gitbook

![example render](https://1679624655-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEkk28J0B2BeDMuesRMr1%2Fuploads%2Fgit-blob-004655bacac0995c23ef78801ceb803a03ed2a64%2F2022-10-19-15-16-05.png?alt=media)

## Useful extensions on VSCodium

* **Dendron Paste Image** will allow you to copy and paste image in your documents. You can set it up to put the image in the proper directory.
* **Markdown all in One** will provide you what you need to confortably write in markdown, including a preview of what you will get in the page.

## Markdown tips

* To highlight some text we can use `>` it will do something like this

> I want to highlight text\
> blabla

* To go to the next line we can add 2 spaces at the end of the line.
* To add some code snippets we can use 1 \` `backquote we can also use 3 \`\`\` if we can to make it a block\
  `my line of code`

```
My block of code
```

### Emojis

[Here](https://gist.github.com/roachhd/1f029bd4b50b8a524f3c) is a list of emojis cheatsheet you can use on markdown\
You can also use [emojipedia](https://emojipedia.org/) but they will not all render as expected.

### Add some colors

You can color your text using html.\
This `<span style="color:blue">blue text</span>`\
Will give this: blue text\
Roses are \textcolor{red}{red}