- Install git if you don't have it. Here's an article on how to install git on Windows/Linux/macOS
- Fork the blog repository and clone it. If you're not sure how to fork or clone a repository, refer to this article or do some googling on your own, or ask someone on our Slack workspace under the #github channel.
If you're not a first time author, feel free to skip to the next section.
- Add your image to the
assets/img/authors
folder and make sure you have a square image. - Open the file
_data/authors.yml
and add your details at the end of the file in the following format:<your-github-username>: name: <your-name> github: <your-github-username> author_image: <filename-of-the-image-you-added> description: <a-descrtiption-of-your-choice> email: <your-email>
- Create a new
.md
file in the_posts
folder and name it in the following format:year-month-date-title-of-your-choice.md
- Add content to your new post in markdown syntax. Refer to this link about Github's flavor of markdown or try googling it if you're not familiar with markdown. Here's an example:
--- layout: post title: "Why GraphQL is a big thing" author_github: githubuser123 date: 2017-05-14 23:32:44 image: '/assets/img/' description: 'Introductory post to GraphQL' tags: - IEEE NITK - CompSoc - GraphQL - API Design categories: - Compsoc/Diode/Piston github_username: 'githubuser123' --- GraphQL is a query language for APIs and a runtime for fulfilling those queries with your existing data. GraphQL provides a complete and understandable description of the data in your API, gives clients the power to ask for exactly what they need and nothing more, makes it easier to evolve APIs over time, and enables powerful developer tools.
- A post consists of the head and the body:
- layout : should always be set to "post"
- title : title of your post
- author_github : your github username
- date : today's date in the format '2020-04-25 17:30:30 '
- image : location of the images, should always be set to 'assets/img/'
- description : a description of your post
- tags : post tags
- categories : categories your post belongs to
- github_username : your github username
- This is where your content goes. In Github's flavor of markdown.
- Create a new branch in your local repository and commit your changes to it.
- Push the newly created branch to the main repository and create a Pull Request
- When making the pull request follow this: - Title : New article: (post title) - Description : A short description about your article
Resolve merge conflcts in your Pull Request, if any. Refer to this link on resolving merge conflicts or try googling or ask someone on our Slack workspace under the #github channel.