Hi there! This is a collaborative website. This is just a proof of concept right now, so it is a featureless barren wasteland of clay yet to be moulded into something resembling anything.
Do you want to contribute and make this into something that's something? Here's how:Contributing to this website
The code for this website is hosted on GitHub, and is deployed to Neocities. In order to contribute to this website, you'll need to make an GitHub account, and do some setup. The following is a brief draft of a guide on using GitHub to collaborate. The goal is to make this guide as accessible as possible to those with a non-technical background.Setting up Git
- First, set up your Github account. A guide for doing so can be found here.
Website Editing
If you are already a collaborator on the GitHub repository, you can follow the following guide to easily make changes. Steps to becoming a collaborator are TBD.- First, copy the repo from GitHub to your local computer, so you can start making changes. Run the following command in the directory where you want to put the website's code.
git clone git@github.com:soweli-sina/web-raft.git
- Make changes to any of the files inside the _site directory, including this one!
- Add and commit all the files. Running with -A will add all new files to the repository; if you only want to add some, you can add then individually.
git add -A git commit -m "Short message describing what you changed"
- Push changes to main! Note, someone else may have pushed a change since you started editing, so first you should update your local version of the code with the following:
git pull
At this point, you may encounter a merge conflict, where the changes you made conflict with the changes someone else made. In this case, you can edit the files where these conflicts happen to resolve them, and then add and commit them again. A more detailed guide on how to resolve merge conflicts can be found here. - After any merge conflicts are resolved, you can push your branch to main, and the neocities page should update after a few minutes.
git push -u origin your-branch-name
- For any additional changes, repeat steps 3 to 6.
NOTE: GitHub only provides a limited amount of job execution time for the free plan per month. When you push a change to GitHub, it will execute a job that will push the changes to Neocities, which takes about a minute. As such, please limit the number of times you push in a month, ideally pushing after making a large set of changes.
If you're not a collaborator yet, you can still make changes! To do so you'd have to set up a merge request from a forked version of this repository. A guide on how to do this in general can be found here, though a guide specific to this site is still pending.