Skip to content

GDSC-DEU/gdsc-deu.github.io

Repository files navigation

MAID WITH Gem Version BUILT WITH PRs Welcome

GDSC DEU logo

GDSC DEU Homepage

Introduce your project and write your articles at GDSC DEU!

Explore GDSC DEU Homepage »

GDSC Chapter · Report Bug · Request Feature


Table of Content

Introduction

GDSC DEU logo
GDSC DEU members can write blog post and introduce their project at this repository. And you can read GDSC DEU information at https://gdsc-deu.github.io.

Prerequisites

  • Ruby version 2.5.0 or higher
  • RubyGems
  • GCC and Make

See prerequrisites for guides and details.

Installation

Install Locally

Below is an example of how you can instruct your audience on installing and setting up your app.

  1. Install all prerequisites.
  2. Install the jekyll and bundler gems.
    gem install jekyll bundler
    
  3. Clone the repo and change into the repo's directory.
    git clone https://github.com/GDSC-DEU/gdsc-deu.github.io.git
    cd ./gdsc-deu.github.io
    
  4. Install all dependency.
    bundle install
    

Using Dokcer

You can also use Docker to run the site locally.

docker run --volume="$PWD:/srv/jekyll" -p 4000:4000 -it jekyll/jekyll jekyll serve

Development

Run development instance (with hot-reload)

bundle exec jekyll serve

Directory Structure

GDSC-DEU.GITHUB.IO/
├── _data                      # Well-formatted site data.
├── _includes                  # The partials of layouts and posts.
├── _layouts                   # The templates that wrap posts.
├── _members                   # GDSC Member Information.
├── _pages                     # Website pages (that are not posts)
├── _posts                     # Where all blog posts will go.
├── _sass                      # Partials of `style.scss` file.
├── _assets                    # Style sheets and images are found here.
|  ├── css                     # CSS file go here.
|  |  └── styles.scss          # Main SCSS file.
|  └── font                    # Font file go here.
|  └── img                     # Image file go here.
├── _config.yml                # Site settings.
├── .gitignore                 # Manage untracked files.
├── 404.html                   # Custom and responsive 404 page.
├── Gemfile                    # Ruby Gemfile for managing Jekyll plugins.
├── index.html                 # Main page.
└── README.md                  # Includes all of the documentation for this site.

Style Guide

Contributing

  1. Create issues about the work.
  2. Create a branch on the issue.
  3. Commit, push to the created branch.
  4. When the work is completed, request a pull request to main branch after rebaseing the main branch.
  5. Review the code and merge it.

Branching

Use author name and issue number into the branch names according to the format below:

<author>_<issue-number>_<branch-type>_<branch-name>

E.g., jiyoon_43_feature_new-experimental-changes

Commit Message

Referred to Conventional Commits.

<type>[optional scope]: <description>
[optional body]
[optional footer(s)]

Maintainers

Current Maintainers: