GitHub for Windows: An Easier Way to Maintain the ‘Home‘ Modules
Creating a new account in GitHub
1. Open the following URL to create a new account in GitHub: https://github.com/
2. Click on the ‘Sign up’ button.
3. Create a new account on GitHub
3.1) Enter a unique username.
3.2) Enter a valid email address.
3.3) Then enter a password and confirm it.
3.4) Click on the ‘Create an account’ button.
3.5) The page gets redirected to the GitHub welcome page.
3.6) Click on the ‘Finish sign up’ button. This takes you to the ‘Create repositories’ page.
How to upload source code to GitHub using windows application?
1. Download & Install GitHub for Windows
You can get GitHub for Windows from the URL: http://windows.github.com/. When you are prompted to open the file, click Run (or possibly Open depending on your browser), and then Install. The installation process may take a few minutes while it downloads the program files from the server.
2. Connecting to GitHub
Once installed, load GitHub for Windows and you will be prompted for your username and password. If you do not already have an account on GitHub, you can click the ‘Sign Up’ link at the bottom of the screen to do so.
3. Adding a Repository
After signing in, GitHub for Windows will ask if you want to add a repository (repo). If you already have repositories created via GitHub’s website or the command line, you can skip this step and download local copies (clone) of your existing repository.
If this is the first time you are using GitHub, name your repository same as your ProcessWire module or theme (or something sensible at least) and click Create.
4. Prepare the source code
Once the application is installed, you can prepare the source code that you want to upload on GitHub.
5. Create new repository
In the GitHub application, click on the + icon to create a new repository to upload the source code.
5.1) First set the Local path by clicking on ‘Browse’ and then select the folder.
5.2) Select the GitHub folder name where you have placed your repository.
5.3) Click on the ‘Create repository’ button to create a new repository.
5.4) Right-click on a repository name like ‘Homes’.
5.5) Select the ‘Open in Explorer’ option.
This creates a folder to link/connect with GitHub.
5.6) Copy file and folder or anything that the user wants to commit on get-up to that folder.
5.7) Now open the GitHub application, and you will see all the folders and files are uploaded and displayed on the right hand side of the Home project.
5.8) Please enter the summary and description in ‘Uncommitted changes’ popup. Then click on ‘Commit to master’ button to commit your changes on GitHub folder.
After clicking on ‘Commit to master’ button you will see your folder and files are committed and green square boxes getting displayed.
5.9) Click on the ‘Publish Repository’ button to publish your code to GitHub.
5.10) Enter the description for this repository and click on the ‘Publish Home’ button.
5.11) Wait for a few seconds and you will see that the application is the uploading source code to GitHub.
5.12) Open the browser and Go to GitHub.com to check whether the source code is published or not.
You will see that the source code folder ‘Homes’ is publicly published on GitHub.
5.13) Click on the uploaded Source code folder ‘Homes’, and you will see that the source code has been uploaded on GitHub.
5.14) Click on the ‘Add or Read me’ button on the source code page.
You will see the read me file has been created in the source code folder structure.
5.15) Open the application and take a look at the top right corner. You will see that the number 1 value near the sync button as a new change in the GitHub source code. Click on the sync button to sync the data between local and online source code.
5.16) Go to your local folder, and you will see that the new Readme1 file has been downloaded.