Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/chipbell4/chipbell4.github.io

My website
https://github.com/chipbell4/chipbell4.github.io

Last synced: 9 days ago
JSON representation

My website

Awesome Lists containing this project

README 

        
# brutalist-blog



## Introduction



![brutalist-blog dark mode homepage](https://user-images.githubusercontent.com/13270895/131266947-65f2ae83-7d9e-48d7-8cd6-05a1d59df0ab.png)

![brutalist-blog light mode homepage](https://user-images.githubusercontent.com/13270895/131266950-3a0e0eff-0b15-4f60-ba22-231bcd78fb0c.png)

![brutalist-blog mobile homepages](https://user-images.githubusercontent.com/13270895/131266952-e245630a-9874-4bde-952c-3c63ebd745e0.png)



brutalist-blog is a no frills, fully-responsive, hyper-minimalistic dark/light theme. The theme is heavily inspired by Mark Otto's personal site: https://markdotto.com/



Demo: https://andrewhwanpark.github.io/brutalist-blog/



My personal site that uses the same theme: https://andrewhwanpark.github.io/



#### Features



- Automatically changes from dark/light modes depending on the OS settings.

- Easy integration with Google Analytics.

- Generates XML sitemap and RSS Atom feed.

- jekyll-seo-tag to add metadata tags for search engines and social networks to better index and display your site's content.

- Full markdown support: code blocks and tables are automatically bootstrap components.



![code blocks](https://user-images.githubusercontent.com/13270895/126393675-dacc65f1-7dd2-4651-ae2b-0e77eda7cd11.png)



![tables](https://user-images.githubusercontent.com/13270895/126393680-7b7fae57-abd0-4843-a9a1-c4f334b5eaa4.png)



## Installation



Clone this repo:



    $ git clone https://github.com/andrewhwanpark/brutalist-blog.git



If you haven't already, install bundler:



    $ gem install bundler



And then execute:



    $ bundle install



Serve the site:



    $ bundle exec jekyll serve



# Installation with Github Pages



After cloning the repo, checkout to the gh-pages branch.



    $ git checkout gh-pages && git pull



In the directory:



    $ bundle install



For local development:



    $ bundle exec jekyll serve



After tweaking with it, you can publish the site. Under your repository name, click Settings.



![tutorial](https://docs.github.com/assets/images/help/repository/repo-actions-settings.png)



In the left sidebar, click Pages.



![tutorial 2](https://docs.github.com/assets/images/help/pages/pages-tab.png)



To see your published site, under "GitHub Pages", click your site's URL.



![tutorial 3](https://docs.github.com/assets/images/help/pages/click-pages-url-to-preview.png)



For a more detailed guide, visit this guide by Github: https://docs.github.com/en/pages/setting-up-a-github-pages-site-with-jekyll/creating-a-github-pages-site-with-jekyll



## Usage



### First things first: \_config.yml



First, you should change data in \_config.yml to the appropriate information such as your social links for the footer icons, avatar for navbar logo, title and name of the site, and more crucial information.



### Adding content



In order to add permanent pages, add in similar fashion to about.md and portfolio.md and add apppropriate data to \_data/navigation.yml.



In order to add blog posts, add in similar fashion to \_posts/2021-07-16-this-post-demonstrates-post-content-styles.md.



### Custom style changes



If you wish to add custom styling through SCSS or CSS, you can add or edit \_sass/main.scss.



### Custom domains with Github Pages



Follow this simple guide: https://medium.com/@xiang_zhou/how-to-add-custom-domain-to-your-jekyll-blog-provided-that-you-built-your-site-using-github-6e1c8bf20afe



## Contributing



Bug reports and pull requests are welcome on GitHub at https://github.com/andrewhwanpark/brutalist-blog.



## License



The theme is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).