Writing is important to proceed with a project as a way to communicate with stakeholders and record the progress. It is so clear that IT projects are especially underlined to be documented well. Many document management applications like Notion, Obsidian, and Evernote allow writers to easily share their notes with others. However, a platform where programmers take time and manage code is GitHub or GitLab which they inevitably utilize. This repository is a template repository for writing papers in markdown format and publishing them on GitHub Pages, which is a free static site hosting service provided by GitHub. The template expects that writers can focus on writing papers in a professional format without considering the design and layout of the paper due to the simple and easy-to-use markdown format.
two columns | one column |
usage case |
- Recommend to use Chrome to see the paper
0. Click use this template
button near the star button
1. Change baseurl
in a _configy.yml
file as your repository
2. Write papers in markdown format
3. Push to your published repository branch
0. Install Jekyll (Ruby, RubyGems, GCC, Make, Bundler are also required)
- Referenced the installation guide of jekyll here
1. Clone your repository (after clicking the use this template
button)
2. Use the following commands to run the server
$ bundle install
$ bundle exec jekyll serve