If you want to contribute a CSS fix, translation, or other issue to the Hydra code base, it's pretty easy to do! You will need a GitLab account.
Note that this guide explains how to use the web interface. If you are doing involved development, you should have Git installed, and make changes locally using the Git command line interface to push them to your remote. That is outside the scope of this page.
- Go to https://gitlab.com/hydrawiki. If you are contributing a CSS change, you will want to then go to the Skins project. A translation change will vary depending on what the translation is for; ask for help if you aren't sure.
- Navigate to the code file that you want to change. If it's a CSS change, this will be in the /css directory.
Here is an example navigation to make a Hydradark change:
- https://gitlab.com/hydrawiki - This is the Hydra GitLab account where all of the groups with repositories from Hydra are.
- https://gitlab.com/hydrawiki/skins - This is the group for all skins, that are currently available.
- https://gitlab.com/hydrawiki/skins/hydradark - This is one of the skins, that are in the repository.
- https://gitlab.com/hydrawiki/skins/hydradark/tree/master/css - This is the folder for the CSS files, that are used in this skin.
- https://gitlab.com/hydrawiki/skins/hydradark/blob/master/css/hydradark.css - This is the main CSS file for the skin.
- Log into your GitLab account if you didn't already.
- Click the "Edit" button or the "Web IDE" button in the upper-right corner of the file, depending on which interface you want to use.
- You will see a message saying `You're not allowed to edit files in this project directly. Please fork this project, make your changes there, and submit a merge request.`. Click "Fork."
- Make your change. Be careful to follow existing whitespace conventions! You might want to make your change locally in an editor like SublimeText or Notepad++.
You might have heard the term "pull request" on GitHub, it's the same thing, but GitLab calls them "merge requests."
- After making your changes, edit the "Commit message" field to have a brief explanation of your changes, for example, "Improve the style of greyed-out Save option in preferences."
- Then press Commit changes.
- It will automatically bring you to a screen to open a merge request. Add a description including why you made the change, and any other relevant information.
- Scroll down and click "Submit merge request" and you're done!