diff --git a/docs/season1/Bases/anubis_pyramid.md b/docs/season1/Bases/anubis_pyramid.md index df7ab48..6c68019 100644 --- a/docs/season1/Bases/anubis_pyramid.md +++ b/docs/season1/Bases/anubis_pyramid.md @@ -3,7 +3,7 @@ import TabItem from '@theme/TabItem'; # Anubis Pyramid -![Anubis Pyramid](/img/season1/bases/anubis_pyramid/2024-07-03_00.05.30.png) +![Anubis Pyramid](/img/season1/bases/anubis_pyramid/anubis-wallpaper.png) diff --git a/docs/wiki/How To Contribute/example-page-code.md b/docs/wiki/How To Contribute/example-page-code.md new file mode 100644 index 0000000..eea4952 --- /dev/null +++ b/docs/wiki/How To Contribute/example-page-code.md @@ -0,0 +1,66 @@ +# Example base post code + +This is the exact code used for the [example page](./example-page.md). You can confirm this for yourself on the Github of course πŸ€—. + +```markdown +import Tabs from '@theme/Tabs'; +import TabItem from '@theme/TabItem'; + +# Example base post + +![Some picture description](/img/season1/2024-07-03_00.03.39.png) + + + + Here can go a short description of the base. + + + | X | Y | Z | + | ----- | ----- | ----- | + | 42 | 69 | -42 | + + + The portals are directly linked with the nether hub. + + + - Albert Einstein + - Neil Armstrong + - Friedrich Nietzsche + - Steve + + + 04/07/2024 + + + +## Lore and Tales + +Some lore. Who doesn't like to write some lore πŸ˜ƒ *italic* **bold** __underline__. `Ever needed code too`? + +### A smaller headline + +#### An even smaller one + +- A list +- more list + +You can also add pictures anywhere in the lore. You may also add more sections if you see fit. It doesn't really matter. Your base, your post! πŸ’ͺ + +## Build Process + +You can maybe describe how you build it. What you enjoyed most. You you just don't include this section add all or replace it with another. Your choice! πŸ’― + +Of course you can also complement your descriptions with pictures of your progression. + +## Additional Pictures + +You cann add more pictures here if you have good ones. People love pictures! 🀩 + +![Some picture description](/img/season1/2024-07-03_00.03.39.png) + +![Some picture description](/img/season1/2024-07-03_00.03.39.png) + +![Some picture description](/img/season1/2024-07-03_00.03.39.png) + +![Some picture description](/img/season1/2024-07-03_00.03.39.png) +``` \ No newline at end of file diff --git a/docs/wiki/How To Contribute/example-page.md b/docs/wiki/How To Contribute/example-page.md new file mode 100644 index 0000000..86865c0 --- /dev/null +++ b/docs/wiki/How To Contribute/example-page.md @@ -0,0 +1,60 @@ +import Tabs from '@theme/Tabs'; +import TabItem from '@theme/TabItem'; + +# Example base post + +![Some picture description](/img/season1/2024-07-03_00.03.39.png) + + + + Here can go a short description of the base. + + + | X | Y | Z | + | ----- | ----- | ----- | + | 42 | 69 | -42 | + + + The portals are directly linked with the nether hub. + + + - Albert Einstein + - Neil Armstrong + - Friedrich Nietzsche + - Steve + + + 04/07/2024 + + + +## Lore and Tales + +Some lore. Who doesn't like to write some lore πŸ˜ƒ *italic* **bold** __underline__. `Ever needed code too`? + +### A smaller headline + +#### An even smaller one + +- A list +- more list + +You can also add pictures anywhere in the lore. You may also add more sections if you see fit. It doesn't really matter. Your base, your post! πŸ’ͺ + +## Build Process + +You can maybe describe how you build it. What you enjoyed most. You you just don't include this section add all or replace it with another. Your choice! πŸ’― + +Of course you can also complement your descriptions with pictures of your progression. + +## Additional Pictures + +You cann add more pictures here if you have good ones. People love pictures! 🀩 + +![Some picture description](/img/season1/2024-07-03_00.03.39.png) + +![Some picture description](/img/season1/2024-07-03_00.03.39.png) + +![Some picture description](/img/season1/2024-07-03_00.03.39.png) + +![Some picture description](/img/season1/2024-07-03_00.03.39.png) \ No newline at end of file diff --git a/docs/wiki/How To Contribute/tutorial.md b/docs/wiki/How To Contribute/tutorial.md new file mode 100644 index 0000000..e9e1065 --- /dev/null +++ b/docs/wiki/How To Contribute/tutorial.md @@ -0,0 +1,131 @@ +--- +sidebar_position: 1 +sidebar_label: Tutorial +--- + +import TOCInline from '@theme/TOCInline'; +import Tabs from '@theme/Tabs'; +import TabItem from '@theme/TabItem'; + +# How to contribute + +This website is a community project for the community and by the community. It is fully open-source with the code being available at [GitHub](https://github.com/aleabodo/survival-pi-docs). It means that every member of the community can literally edit *anything* of the website and contribute to adding new information and posts to it. Obviously, this is as long as the submission adhers to the general theme of the website and doesn't break the it πŸ˜„. The operator of the website is BuildingBrute and will review every change to ensure that no malicious outsider can do damange and no breaking changes are introduced by accident. + +In this tutorial, I will guide you on how to edit, change, and add information to this website. There are two sections based on your technical expertise: + +1. **Easy Method** - For beginners, with simple steps to make edits. +2. **Advanced Method** - For users familiar with Git, explaining how to install, build, and run the website locally for testing. + +Don't be intimidated; contributing is quite straightforward! Rune222 even figured it out before this tutorial was written πŸ€™. + +Here's the table of contents so you can navigate to the right section: + + + +## The easy method {#easy} + +### Some terms + +These are some of the most important terms you should know when working with Git. I will be using them, so I recommend to at least skim over them. + + + + Git is a powerful version control system that helps track changes to files and coordinate work on those files among multiple people. + + + A repository is a storage space where this project lives. It contains all the files and the history of all changes ever made to them. Repositories can be local (on your computer) or remote (on a server like [GitHub](https://github.com/aleabodo/survival-pi-docs)). + + + A commit is like a snapshot of your project at a specific point in time. Each commit contains information about what changes were made, who made them, and when. Think of it as saving your changes to a log book. + + + A fork is a personal copy of someone else's repository that lives on *your* account. It allows you to freely experiment with changes and make commits without affecting the original project. Forking is often used when you want to contribute to a repository you don’t own (as we will see later). + + + A pull request is a way to propose changes you've made (on your fork) to a project so that they can be reviewed and potentially merged ("*pulled*") into the original repository. As you will see later, you'll need to make a PR so I can review your commits before accepting them into the website. + + + +### Follow these steps to make your first Pull Request + +1. **Create a GitHub Account** \ + [Create an account on GitHub](https://github.com/signup). Sign in with your new account. + +2. **Click on *Edit this page*** \ + Visit any page you want to edit and scroll to the bottom. Click on the button `Edit this page`, redirecting you to the corresponding file on the [GitHub repository]((https://github.com/aleabodo/survival-pi-docs)). \ + ![Edit this page button](/img/wiki/edit-this-page.png) + +3. **Follow the instructions to fork the Repo** \ + Since you don't own this repository, GitHub will ask you to create a Fork. Follow the instructions. \ + ![Fork this repository](/img/wiki/fork-this-repository.png) + +1. **Edit the Page** \ + Now you can edit the website's code. Most pages, including the Wiki and Season pages, use Markdown, a simple format you might know from note-taking apps. To learn more, check out [this markdown cheatsheet](https://www.markdownguide.org/cheat-sheet/). To get started quickly, I recommend getting familiar with the existing text and checking out the [example page of a base](https://www.markdownguide.org/cheat-sheet) and the [corresponding code](https://www.markdownguide.org/cheat-sheet). + + :::note[Some footnotes on editing:] + - You can format pages however you see fit, not limited to specific templates. + - All pages of the seasons and the Wiki are in the `/docs/` directory. The sidebar of the website will follow that directory tree. + - Images are in `/static/img/`. If you add images, follow the directory tree: they are organized and named like the pages they accompany. Reference images without `/static`. For example: + ```markdown + ![Pic](/img/season1/bases/anubis_pyramid/anubis-wallpaper.png) + ``` + When you look at the existing code, this will be more clear. + ::: + +2. **Commit Your Changes** \ + Click on `Commit changes...` to create a snapshot of your edits on your forked repository. Please make a meaningful commit messages. Avoid messages like "LOL" or "Changed something". Describe your changes briefly and clearly; this helps the reviewer understand your edits. + +3. **Create a Pull Request** \ + Review your changes and click `Create pull request` to propose merging your commits into the main repository. \ + ![Pullrequest](/img/wiki/pullrequest.png) \ + :::info[Info] + You can make multiple commits on your account's forked repository before making a pull request. This is especially useful if you need to add multiple files like pictures for one page. You can find your repository in your profile under `Your repositories`. + ::: + + +## Advanced method {#advanced} + +:::info +This section assumes you are familiar with Git and can clone a repository. If you're new to Git but want to learn, watch [this video](https://www.youtube.com/watch?v=mJ-qvsxPHpY) to get started. +::: + + +### Installation +You need Node and npm for building this project. I recomment installing and managing it with nvm (https://github.com/nvm-sh/nvm): +``` +curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash +nvm install node +``` +Initialize the project and install dependencies: +``` +npm install +``` + +### Local Development + +``` +npm start +``` + +This command starts a local development server and opens up a browser window. Most changes are reflected live without having to restart the server. + +### Build + +``` +npm run build +``` + +This command generates static content into the `build` directory and can be served using any static contents hosting service or with `npm run serve`. + + +:::danger[Please don't upload massive pictures!] + +Ensure images are at most 720p with some compression for quick loading speeds. On Linux, use these commands to reduce image size: + +``` +sudo apt-get install imagemagick pngquant + +find /path/to/your/directory -type f -name "*.png" -exec mogrify -resize 1280x720\> {} \; -exec pngquant --quality=80 --ext .png --force {} \; +``` + +::: \ No newline at end of file diff --git a/static/img/season1/bases/anubis_pyramid/2024-07-03_00.05.30.png b/static/img/season1/bases/anubis_pyramid/anubis-wallpaper.png similarity index 100% rename from static/img/season1/bases/anubis_pyramid/2024-07-03_00.05.30.png rename to static/img/season1/bases/anubis_pyramid/anubis-wallpaper.png diff --git a/static/img/wiki/edit-this-page.png b/static/img/wiki/edit-this-page.png new file mode 100644 index 0000000..a12a5b5 Binary files /dev/null and b/static/img/wiki/edit-this-page.png differ diff --git a/static/img/wiki/fork-this-repository.png b/static/img/wiki/fork-this-repository.png new file mode 100644 index 0000000..6d99ac1 Binary files /dev/null and b/static/img/wiki/fork-this-repository.png differ diff --git a/static/img/wiki/pullrequest.png b/static/img/wiki/pullrequest.png new file mode 100644 index 0000000..6d9b00a Binary files /dev/null and b/static/img/wiki/pullrequest.png differ