AUGUS

AUGUS is a Jekyll-based personal website template that uses Bootstrap and Material Design and is configured to deploy directly to GitHub Pages, with repository topics pointing to Genshin Impact. It takes Markdown files as input and outputs a static HTML site that can be served locally or published at a GitHub Pages URL.

What is AUGUS?

AUGUS is a Jekyll static site generator template hosted on GitHub under the repository DrAugus/draugus.github.io. It runs on a local Jekyll server or on GitHub Pages, and it is built with Bootstrap for responsive layout and Material Design principles for UI styling. The template serves as a personal website or blog and has a quickstart guide that walks new users through installing Ruby, cloning the repository, and running bundle exec jekyll serve --trace. The site's default local URL is http://localhost:40000, and the port can be changed in the _config.yml file if it is already in use.

Key Features

• Jekyll static site generator — Converts Markdown content into a static HTML site; requires Ruby 2.5.0+, RubyGems, GCC, and Make.
• Bootstrap layout — Uses the Bootstrap grid and responsive components for the page structure.
• Material Design styling — Incorporates Material Design visual elements on top of Bootstrap.
• One-command local preview — Run bundle exec jekyll serve --trace to build and view the site at http://localhost:40000.
• Configurable port — Edit _config.yml to change the local server port if the default is blocked.
• GitHub Pages deployment — Pushing the repository to GitHub serves the site at https://your-username.github.io/project-name.
• Blog and Genshin Impact topics — Repository topics list blog, genshin-impact, and yuanshen, so the template can host personal posts and Genshin-related content.

Who is it for?

• Jekyll newcomers — People who want a working Jekyll template to study; the README lists every prerequisite and command from gem install jekyll bundler to bundle exec jekyll serve.
• GitHub Pages users — Developers who want a free static site hosted by GitHub without configuring a separate server; the template is structured for Pages from the start.
• Genshin Impact content creators — Fans of the game can run a personal blog or fan site; the repository topics explicitly include genshin-impact and yuanshen.

What can you do with AUGUS?

• Personal blogging: Write posts in Markdown and use bundle exec jekyll serve to preview them locally, then push to GitHub to publish.
• Project showcase: Use the static site to present a project or portfolio on a github.io subdomain.
• Jekyll experimentation: Change the Bootstrap and Material styles to learn how Jekyll compiles themes and layouts.

How does AUGUS work?

Clone the repository, install the Jekyll and Bundler gems, and run bundle exec jekyll serve --trace. The command builds the site and starts a local web server at the port specified in _config.yml (default 40000). To publish, push the repository to GitHub and enable GitHub Pages for the branch, and the site appears at your GitHub Pages URL.

FAQ

What prerequisites does AUGUS need?

Jekyll requires Ruby version 2.5.0 or higher, RubyGems, GCC, and Make. The quickstart instructs you to install all four before running gem install jekyll bundler.

How do I change the port AUGUS runs on?

Edit the _config.yml file in the repository root. The QA section of the README explains that if Jekyll fails to start, modifying the port in _config.yml is the recommended fix.

Can I host AUGUS on GitHub Pages for free?

Yes. GitHub Pages hosting for public repositories is free, and the template is designed for it. Push the repository to your GitHub account and enable Pages in the settings.

Is AUGUS a blog theme?

It can be used as a blog. The repository topics include blog, and Jekyll's native structure supports posts; the template also includes Genshin Impact keywords, so it suits a themed personal blog.