Ocelot-Social/edit-this-documentation.md
2023-10-26 19:04:51 +02:00

115 lines
2.5 KiB
Markdown

# Edit this Documentation
Find the [**table of contents** for this documentation on GitHub](https://github.com/Ocelot-Social-Community/Ocelot-Social/blob/master/SUMMARY.md) and navigate to the file you need to update.
Click on the **edit pencil** on the right side directly above the text to edit this file in our repository.
You can see a preview of your changes by clicking the **Preview changes** tab aside the **Edit file** tab.
If you are ready, fill in the **Propose file change** at the end of the webpage.
After that you have to compare your change branch to our `master` branch with a pull request. Here make a comment which issue you have fixed. (If you are working on one of our [open issues](https://github.com/Ocelot-Social-Community/Ocelot-Social/issues) please include the number.)
## Markdown your documentation
To design your documentation see the syntax description at GitBook:
[https://toolchain.gitbook.com/syntax/markdown.html](https://toolchain.gitbook.com/syntax/markdown.html)
### Some quick Examples
#### Headlines
```markdown
# Main Headline
## Smaller Headlines
### Small Headlines
```
#### Tabs
```markdown
{% tabs %}
{% tab title="XXX" %}
XXX
{% endtab %}
{% tab title="XXX" %}
XXX
{% endtab %}
{% endtabs %}
```
#### Commands
~~~markdown
```<LANGUAGE> (for text highlighting)
XXX
```
~~~
#### Links
```markdown
[XXX](https://XXX)
```
#### Screenshots or other Images
```markdown
![XXX](https://XXX)
```
#### Hints for ToDos
```markdown
{% hint style="info" %} TODO: XXX {% endhint %}
```
## Host the Screenshots
### Host on Ocelot-Social \(GitHub\) Repository
{% hint style="info" %}
TODO: How to host on Ocelot-Social \(GitHub\) repository ...
{% endhint %}
### Quick Solution
To quickly host the screenshots go to:
[https://imgur.com](https://imgur.com).
There click the green button **New post**.
Drag the image into the appropriate area.
Right click on it and choose kind of **Open link in new tab**.
Copy the URL and paste it were you need it.
## Screenshot Modification
### Add an Arrow or some other Marking Stuff
{% tabs %}
{% tab title="macOS" %}
#### In the Preview App
Got to: **Menu** + **Tools** \(GER: Werkzeuge\) + **Annotate** \(GER: Anmerkungen\) + etc.
{% endtab %}
{% tab title="Windows" %}
{% hint style="info" %}
TODO: How to modify screenshots in Windows ...
{% endhint %}
{% endtab %}
{% tab title="Linux" %}
{% hint style="info" %}
TODO: How to modify screenshots in Linux ...
{% endhint %}
{% endtab %}
{% endtabs %}