/Poke-Dex

This is a small webpage that allows user to add their favourite Pokémons! This project aims to help people in creating their first pull requests and participating in Hacktoberfest 2020.

Primary LanguageHTMLMIT LicenseMIT

Poké-Dex

Pokémon

There's no doubt that most of our childhood was spent watching Pokémon and playing games like Pokémon Fire-Red, Ruby, Emerald, etc. From Kanto to Hoenn to Sinnoh, we have seen it all and experienced it all. With Hacktoberfest 2020 coming up and being one of the people who would participate for the very first time, I decided to create this repository that's actually a very basic website that lets users view and add their favourite Pokémon.

Contents of the website

  1. index.html - Contains the content of the home page.
  2. index.css - Contains the styling given to the home page.
  3. about.html - Contains some information about me.
  4. about.css - Contains the styling given to the about page.

What can I contribute?

There is always something to contribute to a project whether you are a novice or a veteran. In this project, you can add your favourite Pokémon as a card to the website! Or maybe you didn't like the line that you are reading right now and want to change that. Sure! Why not?

How can I contribute?

Kindly refer to CONTRIBUTING.md file to learn how to contribute!

And that's it! Follow these steps to make your very first pull request.

But what if I don't know how to add cards? :(

Not everyone is aware of every tool present in the world no matter how easy or complex it is. It's also not necessary to know each and every tool out there. So there are two ways to add a pokemon. You only need to do one of these methods otherwise the pokemon will appear twice.

via html

Use the code sample below to add your own card because everyone loves Pokémon and everyone should get a chance to add their favourite Pokémon! Just paste it within the the the div with an id of pokemon-row

<div class="col-lg-4 mb-4">
	<div class="card">
		<img class="card-img-top" src="[Link to Pokémon image]" alt="" />
		<div class="card-body">
			<h5 class="card-title">[Name of your favourite Pokémon]</h5>
			<p class="card-text">[Small Description about your Pokémon]</p>
			<a
				href="[Add the link to your GitHub Profile]"
				class="btn btn-outline-danger btn-sm"
				>Contributed by - [Add your GitHub Username/profile name]</a
			>
		</div>
	</div>
</div>

Copy this code and paste it in the index.html file to make your changes. Test it on your own system and then create a pull request.

via javascript / json

Or an even easier way is to just add an object to the pokemon.json file with

{
	"pokemonName": [Name of your favourite Pokémon],
	"pokemonDescription": [Small Description about your Pokémon],
	"pokemonImage": [Link to Pokémon image],
	"contributedByName": [Add your Github Username],
	"contributedByUrl": [Add a link to your Github profile],
	// these are only needed if you have improved a card
	"improvedByName": [Add your Github Username],
	"improvedByUrl": [Add a link to your Github profile],
},

If all of the pokemon get added to this file, then we can extend this project to include functionality like search and filtering.

Congratulations!

Congratulations! You just made your first pull request and if it gets merged, you can view the changes you made live using the link provided above!