In the video I was highlighting one of my greatest discoveries on GitHub, GitHub Pages. This application is fully integrated to the repositories, however you have to make some special settings to achieve this. For example you need to eliminate (I’m going to that) the master-branch and replace it for this branch gh-pages as the default. By doing so GitHub Pages manage better the repository. Before telling how I know, there's something important about the folders. This is what I found, you need to create a file including the name of the folder first, in the example I click create a file, then wrote “docs/”, then the name of the file with the respective extension, in the example I create an ".html" file. When you create the file the folder is also created and you can upload or create more files there.

GitHub for Poets

But now it’s time to tell you how I learn so much things. ;) Maybe some of you know them, but Im sure I’m going to know them more. I find the youtube channel The train code and there’s the GitHub organization (a group of collaborators in GitHub) called Coding Train, there's where I start to understand more things. In youtube they have a beautiful play list called GitHub for Poets You can imagine my face. In that series of videos they explain the process to make web pages using GitHub, they were who told me to delete the Master Branch. The videos are there and I have no much to say than I’m grateful and I have a lot to learn... and also they're funny!! :)

I’m projecting to get close to other GitHub users who openly share their repositories for other people so they can make contributions in those projects. That's the spirit of the open-source projects. You can make a pull request which means that you are suggesting some code for a part of the repository, maybe some translation, visuals or designs. You get a copy of the whole repository to make and prove your changes and the owner can approve the changes merging them and including in the Master Branch. That’s how the open-source projects can grow.

For now I need to learn more about the different codes that are allowed in GitHub. I confess I was a blogger but this has much, much more potential. I need to check Jekill which is the app that manage to post GitHub Pages in more easy way, but it seem little complex to install. About Wikiversity I’m subscribed too, and when I begin to prepare my articles I will learn the rules and adapt the code to also share the academic articles there.

---

Here is in summary the process of the Project so far:

1.- You need to subscribe in https//utopian.io, for that you need an account related to Steem, as steemit.com. You will be asked for your user and your active key to register.

2.- You need to register in https://github.com, for that registration you will be asked to sig-up using an email adress.

3.- Once in GitHub you can make the “Hello-World” tutorial which link is included in the start page with the option Read the Guide when you sign-in. Or you can go directly to Start a Project and:

• Create a new repository: Here you create the root of your project. By selecting initialize with a README You create a “.md” file which is the front page of your project by default.
• You add a short description for your repository and create it.
• Once in the new repository, you can work on it by selecting the README.md file and then click the pencil in this options:
• The front page of your project can be changed if you create a file called index in the root of your repository, this file could be an html. In this way when you call your page in a browser the Index file will apear.

NOTE: Every time you create or edit some file you need to go to the bottom of the page in the edition and then press commit changes, you have the option to give a title for that commit and also comment it. Every commit in GitHub has his own register in the platform and is the way to interact between colaborators.

4.- You can create or upload the files you need in your project and you can create folders for those files as was explained before.

5.- Once your material is in place you can do the settings to work with GitHub Pages

• In the root of your repository you will find this: In the Branch option you can create a new Branch and call it gh-pages and then here, (this is optional) you can delete the Master Branch . You will have two branches in that moment. This section is where all the Pull-requests from the owner or collaborators are organized.
• Once you've created the gh-pages branch: you need to go to settings on the main page of your repository, there you will see these options:

-Here you choose Branches and you will see the option to change the default branch, select your new gh-pages as the default.
- Return to the main Options menu and scroll down a little to find the options of GitHub Pages
-Once there you select in the Source menu your gh-pages branch.


- In the same section you can choose a Jekill Template which are free templates that you can use in your GiHub Pages project.
- You can click on the link of your GitHub Page in the same section.

6.- Now you are ready to check in your browser the result of your diferent files adding the paths in your url. The leveuf/escenika repository for example, has this url https://leveuf.github.io/escenika/ but if I add the path of a file you will get that page:
https://leveuf.github.io/escenika/docs/ensayo.html

7.- Now you just need to put in practice your coding skills. Or like me you start a research to improve your web designer knowledge, the limits are only those of your choice!!

---

Thanks.

I'm much grateful with @sirrius and @chrisaiki for spent with me those words that gave me the impulse for this adventure! I hope to find more helping hands in this journey thanks to this contribution to an open-source project.

Miguel Ángel Canto @leveuf

---

Posted on Utopian.io - Rewarding Open Source Contributors

---