1
0
Fork
You've already forked website
0
No description
  • SCSS 33.2%
  • HTML 20%
  • Python 14.4%
  • CSS 13.4%
  • Makefile 12.4%
  • Other 6.6%
Find a file
2026年03月18日 00:38:06 -07:00
.github Switch these to 'run' 2026年03月18日 00:38:06 -07:00
_includes Post 2026 refresh changes 2026年03月17日 21:23:55 -07:00
_layouts Drop slashes here 2026年03月18日 00:11:51 -07:00
_pages Add new mod 2024年08月05日 16:25:28 -07:00
_posts urda.com 2026 Theme Rebuild 2026年03月13日 02:52:15 -07:00
_sass Post 2026 refresh changes 2026年03月17日 21:23:55 -07:00
assets Fix again, with lint disable 2026年03月17日 22:38:06 -07:00
blog urda.com 2026 Theme Rebuild 2026年03月13日 02:52:15 -07:00
content Move favicons to new assets folder (...) 2018年08月03日 15:07:19 -07:00
scripts urda.com 2026 Theme Rebuild 2026年03月13日 02:52:15 -07:00
.ackrc Add ackrc 2016年05月12日 11:34:53 -07:00
.gitattributes Update attirbutes again 2015年10月12日 00:38:45 -07:00
.gitignore Working on flipping to deploy-via-actions not pure gh-pages 2026年03月17日 23:53:12 -07:00
.nvmrc urda.com 2026 Theme Rebuild 2026年03月13日 02:52:15 -07:00
.stylelintignore urda.com 2026 Theme Rebuild 2026年03月13日 02:52:15 -07:00
404.md Code block that bit please 2026年03月17日 22:58:36 -07:00
_config.yml Working on flipping to deploy-via-actions not pure gh-pages 2026年03月17日 23:53:12 -07:00
apple-touch-icon.png A few favicons need to be copied to root. 2018年07月29日 18:40:02 -07:00
CNAME Update CNAME 2018年07月10日 23:10:37 -07:00
Dockerfile urda.com 2026 Theme Rebuild 2026年03月13日 02:52:15 -07:00
favicon.ico A few favicons need to be copied to root. 2018年07月29日 18:40:02 -07:00
Gemfile Working on flipping to deploy-via-actions not pure gh-pages 2026年03月17日 23:53:12 -07:00
Gemfile.lock Working on flipping to deploy-via-actions not pure gh-pages 2026年03月17日 23:53:12 -07:00
index.html urda.com 2026 Theme Rebuild 2026年03月13日 02:52:15 -07:00
LICENSE git add LICENSE 2023年05月30日 01:58:49 -07:00
Makefile Working on flipping to deploy-via-actions not pure gh-pages 2026年03月17日 23:53:12 -07:00
package.json urda.com 2026 Theme Rebuild 2026年03月13日 02:52:15 -07:00
pnpm-lock.yaml urda.com 2026 Theme Rebuild 2026年03月13日 02:52:15 -07:00
README.md urda.com 2026 Theme Rebuild 2026年03月13日 02:52:15 -07:00
style.scss urda.com 2026 Theme Rebuild 2026年03月13日 02:52:15 -07:00
stylelint.config.mjs urda.com 2026 Theme Rebuild 2026年03月13日 02:52:15 -07:00

urda.com

My personal website and theme. I post everything from engineering, to programming, to creative works, and other thoughts.

Features of this theme and site generator

Site Settings

  • title - Set the desired title of this website.
  • author - Set the desired author of this website.
  • description - Set this to a description of your site.
  • avatar - Set the path to your avatar image you want displayed.
  • avatar_alt_text - Set the alt text for your avatar image for a11y support.
  • language - Set the site language (e.g., en-US). Used for <html lang> and Open Graph locale.
  • social_image - Default Open Graph sharing image. Override per-page with social_image in front matter.
  • url - Set your website's URL. This needs to be set to support RSS and other features.
    • baseurl - Set this if you need to adjust the base URL (such as a GitHub org website).

Homepage Options and Settings

  • Control the homepage 'oneliner':
    • You can set homepage_oneliner to any string you would like to promote on your homepage.

Socials

You can configure your socials in the config as well under the socials section.

  • email - Set an e-mail address for users to access.
  • flickr - Share your Flickr photos and profile to the world.
  • github - Set your GitHub username to share your code.
  • instagram - Share your moments to the world.
  • linkedin - Share your professional LinkedIn profile to visitors.
  • mastodon - Connects your Mastodon account to the website.
  • rss - Enable or disable the RSS feeds throughout the website.

Excerpts

Post excerpts on the homepage and blog archive are controlled by the content itself:

  • Showcase posts: Place <!-- excerpt_end --> in your content. Everything before the marker becomes the excerpt and is displayed in full.
  • Standard posts: If no marker is present, the excerpt is auto-generated by stripping HTML and truncating to excerpt_truncate_words (default: 50 words) with an inline "Read More" link.
  • Short posts: Posts shorter than the truncation limit are shown in full.

Analytics

This project supports inserting analytics as desired. It currently supports:

  • Cloudflare Web Analytics
    • Set the cloudflare_web_analytics_token value in _config.yml from your token value from your Cloudflare JS snippet.

Working on website content

Creating a new blog post

  1. Create a new file in _posts/ named YYYY-MM-DD-your-title.md.
  2. Add front matter at the top: 
    ---layout:posttitle:Your Post Title---
  3. Write your content in Markdown below the front matter.
  4. Optionally add <!-- excerpt_end --> to control the excerpt shown on listing pages.
  5. For content images, create a directory content/YYYYMMDD/ and reference images with relative paths.

Creating a new page

  1. Create a new file in _pages/ (e.g., _pages/about.md).
  2. Add front matter: 
    ---layout:pagetitle:Aboutpermalink:/about/---
  3. Add the page to site navigation by updating nav_links in _config.yml.

Working on the project

  • This project uses Jekyll to generate the static site.
  • This project uses Sass for styling.
  • This project uses docker to build, test, and serve the site locally.
    • This means you can run all the operations with just a Docker image, no local setup needed.
  • This project uses make to simplify running commands locally and in CI/CD.

Running linting

make lint

Running tests

make test

Managing project version

Check version strings

Get a report on if all version strings match or not.

make version-check

Get version string

Gets the bare version string for the project. If there is an error exit code will be 1.

make version-only

Update version strings

Enter a prompt to update all version values across the project at the same time.

make version-update