Setting up Jekyll on Fedora is straightforward. This guide will walk you through the process of installing Jekyll, using a predefined theme, and setting up Jekyll Admin for managing your site more easily.
Installing Jekyll on Fedora
-
Install Required Dependencies
Start by installing Ruby and other necessary packages:sudo dnf install ruby ruby-devel @development-tools
-
Install Jekyll and Bundler
Once the dependencies are installed, install Jekyll and Bundler using RubyGems:gem install jekyll bundler
-
Verify Installation
Check that Jekyll and Bundler are properly installed:jekyll -v bundler -v
If the commands return version numbers, you’re ready to proceed.
Installing a Jekyll Project with a Theme
You can initialize a Jekyll project using a GitHub repository template that includes your desired theme.
Using a Repository Template
One option is to directly clone a repository with a pre-configured theme. For example, to use the jekyll-theme-serial-programmer
:
git clone https://github.com/sharadcodes/jekyll-theme-serial-programmer.git devblog
This command:
- Clones the project with the theme into a folder named
devblog
.
After cloning, navigate to the project directory:
cd devblog
Install the necessary dependencies:
bundle install
Finally, start the local server:
bundle exec jekyll serve
Installing Jekyll Admin
Jekyll Admin provides an easy-to-use web interface for managing your Jekyll site. Follow these steps to install and set it up:
-
Add
jekyll-admin
to YourGemfile
Open theGemfile
in your project directory and add this line:gem "jekyll-admin"
-
Install Dependencies
Run the following command to install the new dependency:bundle install
-
Run the Server with Jekyll Admin
Start the Jekyll server, and Jekyll Admin will be accessible:bundle exec jekyll serve
-
Access the Admin Interface
Open your browser and navigate to:http://localhost:4000/admin
From here, you can manage posts, pages, data files, and more through the Jekyll Admin dashboard.
Conclusion
By following these steps, you can set up Jekyll on Fedora, use a predefined theme, and enhance your workflow with Jekyll Admin. This setup simplifies both the development and management of your Jekyll site.
Happy blogging and site management! 🚀