Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/lumunix/domain
π Jekyll theme for building a personal knowledge repository and blog
https://github.com/lumunix/domain
blog docker github-pages jekyll jekyll-theme ruby-gem theme
Last synced: 2 months ago
JSON representation
π Jekyll theme for building a personal knowledge repository and blog
- Host: GitHub
- URL: https://github.com/lumunix/domain
- Owner: Lumunix
- License: mit
- Created: 2021-09-28T12:30:14.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2024-07-01T19:27:55.000Z (6 months ago)
- Last Synced: 2024-10-11T09:41:29.985Z (2 months ago)
- Topics: blog, docker, github-pages, jekyll, jekyll-theme, ruby-gem, theme
- Language: HTML
- Homepage:
- Size: 199 MB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
[![License](https://img.shields.io/github/license/Lumunix/domain?style=plastic)](https://github.com/Lumunix/Domain/blob/main/LICENSE)
[![Jekyll](https://img.shields.io/badge/jekyll-%3E%3D%203.7-blue.svg)](https://jekyllrb.com/)
[![RubyGem](https://img.shields.io/gem/v/domain-jekyll?style=plastic)](https://rubygems.org/gems/domain-jekyll)
[![Tip Me via PayPal](https://img.shields.io/badge/PayPal-tip%20me-green.svg?logo=paypal)](https://www.paypal.me/Lumunix)# [Domain](https://lumunix.github.io/Domain/)
Jekyll Knowledge Base / Blog Theme that provides wiki style linking, full text search and automatically generated post organization pages.![Project-Banner](./readme/project-banner.png)
![Showcase](./readme/showcase.png)
## Installation
- Option 1: Use the [Domain Github Pages Initializer](https://github.com/Lumunix/Domain-Github-Pages-Initializer)
- Option 2: Setup as a [gem-based theme](https://jekyllrb.com/docs/themes/#understanding-gem-based-themes)
- Option 3: Setup as a [remote theme](https://blog.github.com/2017-11-29-use-any-theme-with-github-pages/)
- Option 4: Forking/directly copying all of the theme files into your project.### Gem-based method
With Gem-based themes, directories such as the `assets`, `_layouts`, `_includes`, and `_sass` are stored in the themeβs gem, hidden from your immediate view. Yet all of the necessary directories will be read and processed during Jekyllβs build process.
This allows for easier installation and updating as you don't have to manage any of the theme files. To install:
1. Add the following to your `Gemfile`:
```ruby
gem "domain-jekyll"
```2. Fetch and update bundled gems by running the following [Bundler](http://bundler.io/) command:
```bash
bundle
```3. Set the `theme` in your project's Jekyll `_config.yml` file:
```yaml
theme: domain-jekyll
```To update the theme run `bundle update`.
### Remote theme method
Remote themes are similar to Gem-based themes, but do not require `Gemfile` changes or whitelisting making them ideal for sites hosted with GitHub Pages.
To install:
1. Create/replace the contents of your `Gemfile` with the following:
```ruby
source "https://rubygems.org"gem "github-pages", group: :jekyll_plugins
```3. Fetch and update bundled gems by running the following [Bundler](http://bundler.io/) command:
```bash
bundle
```4. Add `remote_theme: "Lumunix/Domain"` to your `_config.yml` file. Remove any other `theme:` or `remote_theme:` entry.
## Usage
For detailed instructions on how to configure, customize, read the [theme's documentation](https://lumunix.github.io/Domain/).
## Development Environment
Included in the repository is a [docker-compose](./docker-compose.yml) file that creates a container from the the official [Jekyll Docker Image](https://hub.docker.com/r/jekyll/jekyll/). This will allow you to setup a development environment without having to install Ruby and Jekyll manually and allow you to quickly test and preview changes.1. Fork this repo. Clone it to your machine.
2. [Install Docker/Compose](https://docs.docker.com/compose/install/). You must have Docker and Compose installed.
3. In the directory you downloaded the project, open terminal and run the following command `docker compose up`.
4. You should now be able to go to your web browser and view the site [Here](http://127.0.0.1:4000/)