Installing GitHub And Adding Images

If you're a student, you can add your name and photo to FOSSASIA's website by uploading your image and editing the students.json file in the _data folder. Steps are described below:

Command Line Method (Recommended)

1. Sign up or login into GitHub

2. Fork this repository using button in right top corner.

3. Enter in console git clone https://github.com/YOURGITHUBUSERNAME/fossasia.github.io.git. This makes a local copy of all files from the repository.

4. Go to the folder using cd fossasia.github.io command. cd means to Change Directory.

5. Copy your photo to images/students directory. **If the image isn't exactly square (i.e., width = height ), it cannot be accepted. About 300px x 300px is good. Please ensure a lowercase extension (jpg instead of JPG).

6. Enter command git add images/students/nameofyourphoto.yourfilextenstion into the command line. This adds your image to git.

7. Use any editor to open _data/students.json file. See the template below and edit it with your own data. For social networks, please only enter your username, not the whole URL. Feel free to remove lines of social networks you're not a part of.

{
    "social": {
        "github": "your github username",
        "twitter": "your twitter username, no @",
        "facebook": "your facebook username",
        "mail": "your email ID",
        "link": "A link to your website/other profile",
        "gplus": "Google plus username, without +"
    },
    "imgName": "The filename of the image you added.extension",
    "name": "Your Name"
},

8. Enter command git add _data/students.json to add changes to git.

9. Commit changes to git by entering git commit -m "Added photo and information" in the console.

10. Send them to the server by typing git push origin master in the console.

11. Go to the browser and your forked repository and press the green "Pull request" button.

12. Describe what changes have you made and press "Create pull request".

13. You're done! Wait till your pull request is reviewed.

GUI (For Windows users only)

1. Signup for a GitHub account , or Login if you already have one.

2. Download the setup for GitHub from Windows GitHub

Click on Download GitHub for Windows to download GitHub.

3. The download will take a while (depending on your Internet connection). After the installation, a window like this should appear:

4. Login and then open up your web browser and log in to your account. Go to FOSSASIA's GitHub Repository and click on Fork at the top right corner.

5. Open up your GitHub client and clone the repository by clicking on the + sign on the top right corner, selecting Clone and then Clone fossasia.github.io.

6. The cloning process may take a while. After that, open up the cloned folder fossasia.github.io, navigate to images/students and add your image there.

7. Use any editor to open _data/students.json file. See the template below and edit it with your own data. For social networks, please only enter your username, not the whole URL. Feel free to remove lines of social networks you're not a part of.

{
    "social": {
        "github": "your github username",
        "twitter": "your twitter username, no @",
        "facebook": "your facebook username",
        "mail": "your email ID",
        "link": "A link to your website/other profile",
        "gplus": "Google plus username, without +"
    },
    "imgName": "The filename of the image you added.extension",
    "name": "Your Name"
},

The text without inverted quotes should be your own credentials—your own facebook URL (not the complete, but just the part after .com), your email, your twitter (without the @) etc. Note the commas and the quoted values. All social links are optional, you can even remove the social part entirerly.

8. When you are done, your GitHub client’s window should look something like this:

Describe the changes made and then click on Sync at the top right corner.

9. After that, open up your forked repository from your profile with the url https://github.com/[yourusername]/fossasia.github.io.git.

10. Now click on Pull Request; describe the changes you made and click on Create Pull Request.

You're done! Wait till your pull request is reviewed.