Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/casmo/casmo.github.io
A personal website.
https://github.com/casmo/casmo.github.io
Last synced: 16 days ago
JSON representation
A personal website.
- Host: GitHub
- URL: https://github.com/casmo/casmo.github.io
- Owner: Casmo
- License: other
- Created: 2024-11-29T16:22:48.000Z (23 days ago)
- Default Branch: main
- Last Pushed: 2024-11-29T16:32:07.000Z (23 days ago)
- Last Synced: 2024-11-29T17:30:17.140Z (23 days ago)
- Language: SCSS
- Size: 22.5 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# Dark Poole
Dark Poole is a permanent dark theme of the Poole theme by [@mdo](https://github.com/mdo). I made the theme darker, inspired by [Derek Kedziora's site](https://derekkedziora.com/). Unlike default Poole that utilizes CSS media queries to activate dark mode, the theme will stay dark regardless of the user's preference.
- I added a navbar that is easily customizable. Check out [Development](#development) to see how.
- I also got rid of the "tagline" in the navbar. I think it looks cleaner without it.
- Finally, I changed the default font size to 20px. I have 20/20 vision and still thought the original font size was too small.
That's it! I tried to be least intrusive as possible to the Poole code base.
**I noticed that Poole's documentation is slightly outdated and misleading. This documentation will try to address most, if not all, of these issues.**
---
## Contents
- [Usage](#usage)
- [Development](#development)
- [Author](#author)
- [License](#license)
## Usage
### 1. Install dependencies
Poole is built on Jekyll and uses its built-in SCSS compiler to generate our CSS. Before getting started, you'll need to install the Jekyll gem and related dependencies:
```bash
$ gem install jekyll jekyll-gist jekyll-sitemap jekyll-seo-tag
```
### 2. Install bundler
You must have bundler installed. If you already have bundler installed, please skip this step.
```bash
# Update Rubygems
$ gem update --system
# Update bundler
$ gem install bundler
```
### 3. Running locally
To see your Jekyll site with Poole applied, start a Jekyll server. In Terminal, from `/dark-poole` (or whatever your Jekyll site's root directory is named):
```bash
$ bundle exec jekyll serve
```
Open in your browser, and voilà.
### 4. Serving it up
If you host your code on GitHub, you can use [GitHub Pages](https://pages.github.com) to host your project.
1. Fork this repo and switch to the `gh-pages` branch.
1. If you're [using a custom domain name](https://help.github.com/articles/setting-up-a-custom-domain-with-github-pages), modify the `CNAME` file to point to your new domain.
1. If you're not using a custom domain name, **modify the `url` in `_config.yml`** to point to your GitHub Pages URL. Example: for a site hosted at `username.github.io`, use `http://username.github.io`.
1. If you want to use your repo name as a base url, **set the `url`** to your repo link and **set the `baseurl`** to your repo name in **`_config.yml`**. Example: for site hosted on `https://username.github.io/dark-poole`, set `url` as `https://username.github.io/dark-poole` and `baseurl` as `/dark-poole`.
1. Done! Head to your GitHub Pages URL or custom domain.
No matter your production or hosting setup, be sure to verify the `baseurl` option file and `CNAME` settings. Not applying this correctly can mean broken styles on your site.
### 5. Pagination for sites with base urls
If you are using a base url for your site, (for example, hosted on `https://username.github.io/dark-poole`) you have to make some changes to get jekyll-pagination to work correctly:
In `_config.yml`, add this line:
```yaml
paginate_path: "/baseurl/page:num/"
```
In `archive.md`, add `{{ site.baseurl }}` before `{{ post.url }}`
```html
```
In `index.html`, remove the `prepend:`:
```html
Newer
```
## Development
Poole has two branches, but only one is used for active development.
- `master` for development. **All pull requests should be to submitted against `master`.**
- `gh-pages` for hosted demo **Please avoid using this branch.**
CSS is handled via Jeykll's built-in Sass compiler. Source Sass files are located in `_sass/`, included into `styles.scss`, and compile to `styles.css`.
### Customize Navbar
You can easily customize the navbar by tweaking the `_config.yml` file. Simply change the title and url of each of the nav elements, or add more. The order will be preserved in the site.
```yaml
nav:
- title: Blog
url: /archive
- title: About
url: /about
```
## Author
**Mark Otto**
-
-
## License
Open sourced under the [MIT license](LICENSE.md).
<3