|
1 week ago | |
---|---|---|
pages | 1 week ago | |
themes/grav-theme-howto | 2 months ago | |
vagrant | 1 month ago | |
.gitignore | 2 years ago | |
README.md | 2 years ago | |
README_ES.md | 2 years ago | |
disroot_h2_title.png | 2 years ago | |
facss | 2 years ago |
| Disroot Howtos | Disroot Website |
This repository contains the Disroot's Howto Project files and the information to create, modify and translate those files.
The main objective of the Disroot's Howto Project is the creation, maintenance and accessibility of user guides, tutorials and configurations of the different services and software that the Disroot platform provides. And also provide the tools, instructions and procedures for anyone who wants to contribute by creating, modifying and translating these guides.
In order to get a copy of the project on your local machine and start to work, you should follow these instructions.
First of all, you need to have installed the following software.
git
A version control system for tracking the changes that are implemented to the howtos and translations as they're being written.
What is git? / Download & installation instructions / Disroot's Git Basics Howto
A text editor with markdown format files support
Suggested software: Atom Text Editor, a source code editor with git version control integrated.
Download & installation instructions
In order to send changes you make to the howtos, whether translating, editing, or writing them, you need to have an account in a Gitea instance.
To register an account at the instance where our repository is, go here.
In order to be able to commit changes to Disroot's git repository, you'll need to request access. This is done via our git project page
This is necessary to be able to send your work from your machine to the remote repository. To setup the git username and email
open a terminal and start git
git init
type and complete with your information the following commands:
git config --global user.email user@email
git config --global user.name "User Name"
The process of creating or translating howtos is not difficult and requires only a bit of practice to learn.
The first thing to do is cloning the repository, this means making a local copy of the remote files. All the work will be done on this copy.
A git repository is a project folder containing the files created or to be translated and the detailed track history of those changes.
To clone the repository, open a terminal in the directory you would like to clone the repository to. Once there you'll use the git clone
command, an instruction to clone a repository by typing its address. In our case it would be:
git clone https://git.disroot.org/Disroot/howto
Once the repository has been copied to your hard drive you'll see a howto
directory containing all the files of the project. It can be later moved to any place on your computer.
Once you have copied the repository to your machine, you can start creating, editing and/or translating by following the steps described in these guides:
The Disroot's Howto documentation is licensed under a Creative Commons Attribution-ShareAlike 4.0 International License