Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/vinitkumar/white-paper
Simple, elegant and clean jekyll theme.
https://github.com/vinitkumar/white-paper
html jekyll jekyll-blog jekyll-site jekyll-template jekyll-themes white-paper
Last synced: about 21 hours ago
JSON representation
Simple, elegant and clean jekyll theme.
- Host: GitHub
- URL: https://github.com/vinitkumar/white-paper
- Owner: vinitkumar
- License: mit
- Created: 2014-06-30T14:56:52.000Z (over 10 years ago)
- Default Branch: gh-pages
- Last Pushed: 2024-06-11T22:11:34.000Z (6 months ago)
- Last Synced: 2024-10-29T23:35:51.839Z (about 2 months ago)
- Topics: html, jekyll, jekyll-blog, jekyll-site, jekyll-template, jekyll-themes, white-paper
- Language: CSS
- Homepage: http://vinitkumar.github.io/white-paper/
- Size: 9.53 MB
- Stars: 227
- Watchers: 5
- Forks: 146
- Open Issues: 12
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# White Paper
**White Paper** is a theme for Jekyll. It is made keeping content in focus and is best for writers/developers who also like to share code with their essays.
## Create blog posts
`jekyll-compose` gem is now installed with jekyll so now creating a new post is as easy as running this simple command
```
# ensure all the required bundles are installed
bundle install
bundle exec jekyll post "Tooling Considered Harmful"Configuration file: /Users/vinitkumar/projects/vinitkumar.github.com/_config.yml
New post created at _posts/2019-03-06-tooling-considered-harmful.md$ git status
Untracked files:
(use "git add ..." to include in what will be committed)_posts/2019-03-06-tooling-considered-harmful.md
```## White Paper in Action
#### Blog Page
![home](./listview.png)
#### Detail Page
![post detail](./detailview.png)
#### About Page
![about](./about.png)
## How to use White Paper
Fork the repo to your account by clicking the button on the top right as shown in the image:
![fork](https://cldup.com/vOF0oaUkh5-3000x3000.png) and then where you want to fork it as shown below.
Next, Go the the project settings and change the repository name to `.github.io` where username is your username.
Change these entries in the `_config.yml` file:
Also, change this line in head.html [link](https://github.com/vinitkumar/white-paper/blob/9ad021a8f94c6240351bd57eda301b5f207e554e/_includes/head.html#L28)
```html
```
This will make sure that the path of CSS is correct and the theme loads correctly.
```yml
master_repo: false
url: ".github.io"
rtl: false # change to true if posts is in Arabic/other Right to left language.
```
Also, change all other fields in the `_config.yml` file to your choice.## Installation
### Local Development
This theme requires you to install couple of tools first to setup jekyll locally.
```$
git clone [email protected]:vinitkumar/white-paper.git# If you have ruby installed.
gem install jekyll bundler# If you have node installed.
npm install
sudo npm install -g grunt-cli #to get the task runner for grunt.
bundle install
jekyll serve# on running the serve script, the site will be live on
http://127.0.0.1:4000
```
This theme uses grunt to concat & minify the css for best performance. In order to prepare the css build. Run `grunt`
It will create a main.min.css file in the css folder.### Switch Syntax Highlighting.
This theme also provides syntax highlighting in different theme. Inside css folder, there is a syntax folder.
```$
.
├── emacs.css
├── github.css
├── monokai.css
├── native.css
├── syntax.css
└── vim.css```
Now in the gruntfiles.js
```js
concat: {
dist: {
src: [
'css/base.css',
'css/sytax/emacs.css', // change this to another theme if you prefer, like vim.css and run grunt
'css/octicons.css'
],
dest: 'css/<%= pkg.name %>.add.css'
}
}
```## Contributors
### Code Contributors
This project exists thanks to all the people who contribute. [[Contribute](CONTRIBUTING.md)].
#### Organizations
Support this project with your organization. Your logo will show up here with a link to your website. [[Contribute](https://opencollective.com/whitepaper/contribute)]
## License
* see [LICENSE](https://github.com/vinitkumar/white-paper/blob/gh-pages/LICENSE) file## Version
* Version 5.0.0## Contact
#### Developer* Homepage: http://vinitkumar.me
* e-mail: [email protected]
* Twitter: [@vinitkme](https://twitter.com/vinitkme "vinitkme on twitter")