The White Paper theme for Jekyll is designed for writers and developers who want their content to shine while also sharing snippets of code seamlessly. Let’s walk through how to create and configure your blog using this theme!

Creating Blog Posts with Jekyll

With the jekyll-compose gem installed, creating new posts becomes straightforward. Simply run the following command in your terminal:

bundle exec jekyll post

Ensure Required Bundles are Installed

Before you create a new post, ensure all your required bundles are installed. Run these commands:

bundle install

Once that’s done, you can check your newly created post using:

git status

This command helps you spot any untracked files, showing your newly created post ready for edits!

Configuring Your Repository

To start customizing your White Paper theme, fork the repository to your account. Here’s how:

• Click the “fork” button at the top right of the GitHub page.
• Navigate to the project settings and rename your repository to username.github.io where your username is applied.

Modify the entries in your _config.yml file according to your preferences. Key modifications include:

master_repo: false
url: username.github.io
rtl: false  # change to true if posts are in Arabic

Installing for Local Development

For local development, install essential tools. Here’s what you’ll need:

git clone git@github.com:vinitkumar/white-paper.git
gem install jekyll bundler

If you also have Node installed, execute:

npm install
sudo npm install -g grunt-cli

To run your Jekyll site locally, use:

bundle install
jekyll serve

Your site should now be live at http://127.0.0.1:4000!

Enhancing CSS for Better Performance

This theme utilizes Grunt for optimizing CSS. To build CSS, run:

grunt

This will create a main.min.css file in the css folder for improved performance.

Switching Syntax Highlighting

For developers who prefer different syntax highlighting themes, change the theme in the gruntfile.js under the syntax folder:

• Locate the line that lists available themes (e.g., emacs.css)
• Change it to your desired theme, such as vim.css, and run Grunt again.

Common Troubleshooting Tips

If you encounter issues while setting up the White Paper theme, here are a few troubleshooting ideas:

• Ensure your Ruby and Node installations are up-to-date.
• Check that your _config.yml file is correctly configured and matches your repository name.
• If CSS is not loading, double-check the link to your CSS file in head.html as outlined earlier.

For more insights, updates, or to collaborate on AI development projects, stay connected with fxis.ai.

Conclusion

At fxis.ai, we believe that such advancements are crucial for the future of AI, as they enable more comprehensive and effective solutions. Our team is continually exploring new methodologies to push the envelope in artificial intelligence, ensuring that our clients benefit from the latest technological innovations.