These projects were built to create a fun, judgement free space for those learning Git and Github to practice making pull requests, branches, adding features, and more. π π π π π
Below are instructions for how to contribute to this project. The easiest way to make a contribution is to add an Emoji Card
to the website. This card should show a number of emojis that match a book or play.
For other ways to contribute, see the repo Issues under the label 'enhancement'. If you want to work on one of the features but aren't sure where to start, write a comment and I will be happy to help you out or get you started. You are also welcome to suggest other features by adding an Issue.
Below are some guidelines to follow when contributing to this project.
π We are limiting contributions per person to 3 additions across EmojiScreen, EmojiBops and EmojiPages. (Updated Oct 1)
- Please limit yourself to up to 3 additions across the three emoji projects. (Example One: Complete 1 feature, add two movies; Example Two: add three songs; Example Three: add one song, one movie and one book, etc). This is due to the high level of activity on these projects at the moment. We want to make sure many people have a chance to contribute. The limit will be lifted once the activity has died down. π
- If your Pull Request is a duplicate, we will let you know so that you can update it if you like.
If someone has commented inside of the Issue saying they are working on it, that item is reserved for them.
- Please choose something else to add if someone else has already said they will add something. We will let you know if you accidently add something that someone else is assigned. It is easy to tell if someone is adding something accidently vs if they are ignoring our rules. We will mark Pull Requests as invalid (and therefore it will not count towards Hacktoberfest) if you are purposely creating multiple Pull Requests for Issues that someone else is assigned to or has reserved.
- We are not accepting Pull Requests for things such as white space updates or README.md updates for Hacktoberfest. These types of Pull Requests will be marked as invalid.
- We do not need additional maintainers at this time. To avoid confusion and incorrect approvals, only maintainers approve Pull Requests.
If you want to work on one of the Issues to add a book
- Please comment in the Issue so that others know to not add that book. You do not have to wait for confirmation for Issues adding books or plays before creating a Pull Request. Your comment will just help 'bookmark' the Issue for you to prevent duplicate Pull Requests.
- Please comment in the Issue and wait for confirmation before you start working on it.
Read below for a detailed overview and walkthrough on how to add an Emoji Card
to this project. Please read all of the instructions before contributing! First time pull-requests are encouraged and you can make multiple pull requests if you desire. If you run into trouble, feel free to create an Issue!
- Choosing a Book or Play to Add
- Emoji Card Overview
- Contribution Walkthroughs
- Git & Github Resources
- Credits
Here are some links to lists of books and plays in case you're having trouble thinking of something to add!
- The Greatest Books List
- ALL-TIME 100 Novels - Time Magazine
- 100 (Fiction) Books to Read in a Lifetime
- 102 of the Greatest Books by Female Authors
- 60 must-read books by women
- Goodreads Best Book Lists
- Top 100 Stage Plays of All Time
- The Best Writers of All Time
- New York Times Bestsellers
On the website, each Emoji Card
displays 1) images of the emojis, 2) a hint icon that will show the year the book was published (when the user hovers over the question mark) and 3) the name of the book (which appears when the user clicks on a card).
In the data.js
file, each Emoji Card
consists of the following object:
{
title: "The Devil Wears Prada",
author: "Lauren Weisberger",
emojiImgs: "ππ©π»βπ¦³π π©π»ππ",
genres: ["drama", "comedy","romance"],
year: 2003
}
To add a new card to the website, add a new object in the data.js
file. Make sure to separate your new object from existing objects with a comma. Below is an overview of each key in the Emoji Card
object. Every key is required.
Each card must have a title. This should be the full title.
{
title: "The Devil Wears Prada",
}
Add the author as a string. If there are multiple authors, include them all in one string such as author: "Author One, Author Two"
.
{
author: "Lauren Weisberger",
}
The emojis should be added to emojiImgs
as a string. Your emojis should be surrounded by double quotation marks.
{
emojiImgs: "ππ©π»βπ¦³π π©π»ππ",
}
Using JavaScript, the emojis are converted into Twemoji (Twitter's emoji version) so that all emojis will be uniform across platforms. And because they are pretty cute. π
Here are a few resources to find emojis to copy:
- Twitter Emojis - Shows you what each Twitter emoji looks like.
- Get Emoji and EmojiCopy are tools to copy regular emojis easily from one page. Note: The initial homepage does not display all skin color versions of each emoji so you will need to search in Emojipedia for those.
- Emojipedia - A directory of all emojis.
Note when you copy these emojis and paste them into your text editor or Github, they will no longer look like the Twitter emojis. But don't worry, Javascript will convert them to the Twitter emojis on the EmojiPages website.
The genres should be added as an array (the square [] brackets indicates an array or list). Separate each genre with a comma and each genre should be wrapped in quotes. There is no limit to the number of genres but try not to add too many.
{
genres: ["drama", "comedy","romance"],
}
Select your genres from this list of genres. If you want to use a genre that is not on this list, in your pull request please add the genre to the genres.md
file.
If you need ideas for what genres to select, you can check the Wikipedia page for the book as well as the Goodreads page for the book to help you out.
Specify the year the book was published. This should be a single number with no quotations around the year.
{
year: 1994
}
Follow these instructions to add a card. You can add a card using the Github website user interface or on your local machine. If you do not already have one, create a Github account before proceeding.
If you are already comfortable using Github and Git, feel free to skip the instructions below and make a pull request using whatever method you prefer!
This method will use the Github website to contribute to this project. You will not need to download any programs to your computer using these instructions.
- Check the Issues and Pull Requests to see if the book you would like to add is listed. If it is not listed as an Issue or Pull Request, continue to the next step. If it is listed as an Issue or Pull Request already, please choose something else to add.
- Fork this repository. This will create a copy of the repository and create a new repository on your account. Note: the
Fork
button is located in the top right area of the repo. - Once the repo is forked, you will be taken to the forked repo. Note: In the top left, the name of the repo should now include your username.
- Navigate to the
data.js
file in your forked repo by clicking on the file name. - Edit the
data.js
file by clicking on the pencil icon and add a new object for your book or play in alphabetical order. Note: If the title starts with 'The' then use the next word for alphabetical order. Make sure there is a comma between your object and the object above and below. Refer to the card overview above for requirements for the different object keys.
Use the following object as a template:
{
title: "The Devil Wears Prada",
author: "Lauren Weisberger",
emojiImgs: "ππ©π»βπ¦³π π©π»ππ",
genres: ["drama", "comedy","romance"],
year: 2003
}
- Once you have completed updating the object for your book, scroll to the bottom of the page and add a commit message. The commit message should be formatted like:
Added 1984
orAdded all of the Harry Potter books
. Click theCommit Changes
button to save your changes.
- Navigate to the
Pull Request
tab. Click on NewPull Request
.
- Review your changes and then click
Create Pull Request
. Add any additional comments, go through the checklist within the Pull Request and add an Issue number if applicable, then click onCreate Pull Request
. - Wait for feedback/review of your Pull Request. Your code will be reviewed and if any changes need to be made, we will let you know. Once your pull request is accepted, you will be able to see your card at https://emojipages.com and you will officially have contributed to the project! π
This method will use your local machine to contribute to the project. This will require you to download multiple programs onto your computer. This is the method most programmers use when working on projects.
- Terminal (Mac OS) or Command Prompt. These are installed by default on your computer. Search for the program to open it. For Windows, Git Bash is recommended.
- Git - This is a version control tool. For Windows, this download will include Git Bash.
- A text editor such as Sublime Text, Atom, Visual Studio Code, etc.
- Check the Issues and Pull Requests to see if the book you would like to add is listed. If it is not listed as an Issue or Pull Request, continue to the next step. If it is listed as an Issue or Pull Request already, please choose something else to add.
- Fork this repository. This will create a copy of the repository and create a new repository on your account.
- Once the repo is forked, you will be taken to the forked repo. Note: In the top left, the name of the repo should now include your username.
- Download the project to your computer. Click on the
Clone or Download
button. Copy the HTTPS github repo link. - In your terminal, navigate to where you would like to save the project (such as
cd Desktop
). Run the following command in the terminal, replacing the following link with your copied link:git clone https://github.com/your-username-will-be-here/emojipages.git
; - After the command has been run, in the terminal, navigate into the EmojiPages project folder:
cd emojipages
. - Open the
emojipages
project in your text editor of choice. Edit thedata.js
file and add a new object for your book or play in alphabetical order. Note: If the title starts with 'The' then use the next word for alphabetical order.. Make sure there is a comma between your object and the objects above and below. Refer to the card overview above for requirements for the different object keys. Make sure to save your file after you have made changes.
Use the following object as a template:
{
title: "Matilda",
author: "Roald Dahl",
emojiImgs: "π©βπ«ππ§π¦πβ¨",
genres: ["children","fantasy"],
year: 1988
}
- If you would like to see what your addition will look like, open the
index.html
file that is in theemojipages
folder in a web browser. TheEmojiCards
are added in a random order so it may take you a few seconds to find what you added. If you do not see any cards in the browser, this could mean that you have a typo in yourdata.js
file. If that is the case, double check what you have added for missing commas and quotation marks. - Once you are done, go to the terminal and type
git status
. You should seedata.js
as modified. If you don't see this, go back and make sure to save yourdata.js
file. - Run
git add -A
to add your changes. - Add a commit message. Run the following command and replace with your movie or show name:
git commit -m "Added 1984 by George Orwell"
. - If you have never used git on your computer before, you will see a message asking for you to set your email and username. If you do not see that message, continue to the next step. Run the following commands, replacing "[email protected]" with your Github email and "Your name" with your github username:
git config --global user.email "[email protected]"
git config --global user.name "Your Name"
Then re-run the commit command. Remember to replace with your book or play: git commit -m "Added 1984 by George Orwell"
-
Run
git push
. If you have not done this before, git push will not run until you login to your Github account. Type in your Github username and password. NOTE: When you type your password, it will not show in the terminal. Press enter after you type your password to continue. -
Go to the Github website and navigate to the
Pull Request
tab. Click on NewPull Request
.
- Review your changes and then click
Create Pull Request
. Add any additional comments, go through the checklist within the Pull Request and add an Issue number if applicable, then click onCreate Pull Request
. - Wait for feedback/review of your Pull Request. Your code will be reviewed and if any changes need to be made, we will let you know. Once your pull request is accepted, you will be able to see your card at https://emojipages.com and you will officially have contributed to the project! π
- Git Handbook
- Additional Git/Github Practice
- Visualizing Git Commands Tool
- Try creating a new branch for your pull request.
- Syncing your Fork
πCheck out a list of all of the EmojiPages contributors.
Emoji graphics are by Twitter and are licensed under CC-BY 4.0. Review the Attribution Requirements for more information.
Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.