{"id":21495243,"url":"https://github.com/christophera/basetheme-demosite","last_synced_at":"2025-08-21T07:41:35.895Z","repository":{"id":264122294,"uuid":"892364483","full_name":"ChristopherA/BaseTheme-DemoSite","owner":"ChristopherA","description":"A demonstration of minimal Jekyll website using BaseTheme as a remote-theme.","archived":false,"fork":false,"pushed_at":"2024-12-07T21:55:24.000Z","size":49,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-08-18T04:45:15.721Z","etag":null,"topics":["jekyll","jekyll-remote-theme","jekyll-template","jekyll-theme"],"latest_commit_sha":null,"homepage":"https://christophera.github.io/BaseTheme-DemoSite/","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"cc0-1.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ChristopherA.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2024-11-22T01:14:02.000Z","updated_at":"2024-12-07T21:55:27.000Z","dependencies_parsed_at":"2025-06-05T00:39:26.082Z","dependency_job_id":"c38f9575-201e-4ce2-9fac-5745c03009bf","html_url":"https://github.com/ChristopherA/BaseTheme-DemoSite","commit_stats":null,"previous_names":["christophera/basetheme-sitedemo","christophera/basetheme-demosite"],"tags_count":0,"template":true,"template_full_name":null,"purl":"pkg:github/ChristopherA/BaseTheme-DemoSite","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ChristopherA%2FBaseTheme-DemoSite","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ChristopherA%2FBaseTheme-DemoSite/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ChristopherA%2FBaseTheme-DemoSite/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ChristopherA%2FBaseTheme-DemoSite/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ChristopherA","download_url":"https://codeload.github.com/ChristopherA/BaseTheme-DemoSite/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ChristopherA%2FBaseTheme-DemoSite/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":271446898,"owners_count":24761421,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-21T02:00:08.990Z","response_time":74,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["jekyll","jekyll-remote-theme","jekyll-template","jekyll-theme"],"created_at":"2024-11-23T16:10:06.587Z","updated_at":"2025-08-21T07:41:35.860Z","avatar_url":"https://github.com/ChristopherA.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# BaseTheme-DemoSite\n\nThis is a demonstration and template site built using [BaseTheme](https://github.com/ChristopherA/BaseTheme). While BaseTheme provides a lean foundation for static sites on GitHub Pages, this DemoSite shows how to build upon that foundation, illustrating both basic usage for web pages and optional features such as blog posts.\n\nThink of BaseTheme as your starting point - a foundational building block. This DemoSite shows you how to add additional blocks together for a complete lean website.\n\n## Features\n\n- 🪶 Minimal, no-bloat foundation, no JavaScript required\n- ✍️ Write naturally - no YAML front matter needed\n  - 📄 Page titles from first heading\n  - 🎯 Automatic layout detection\n- 🎨 Flexible styling options\n  - 🌓 Dark mode support\n  - 🖨️ Print-friendly layouts\n- 🌐 Responsive and accessible by design\n  - 📱 Mobile-first approach  \n  - ♿️ WCAG compliance built-in\n- 🔍 SEO-ready with metadata and sitemaps\n\n### Additional Features (Demonstrated Here)\n- 📑 Multi-page navigation\n- 📰 Blog post support with RSS feed\n\n## See It In Action\n- View the [live demo](https://christophera.github.io/BaseTheme-DemoSite/)\n- See [BaseTheme](https://github.com/ChristopherA/BaseTheme) for core foundation\n- Full template files in this repository\n\n## Quick Start\n\n1. Use GitHub's \"Use this template\" button to create your repository\n2. Customize `_config.yml` - change the required settings to match your site, and delete any optional sections (like blog and social media) that you don't need:\n3. Enable GitHub Pages in your repository settings\n\n## File Structure\n```\n.\n├── _config.yml          # Site configuration\n├── _pages/             # Static pages\n│   ├── about.md        # Example page\n│   └── blog.md         # Blog index page\n├── _posts/             # Blog posts\n│   └── YYYY-MM-DD-*.md # Post files\n└── index.md            # Home page\n```\n\n## Creating Content\n\n### Static Pages\nAdd markdown files to the `_pages` directory with a level-one heading (# Title). The heading becomes the page title, and the layout is chosen automatically. No front matter is needed.\n\nYou can override any defaults by adding optional front matter:\n\n```markdown\n---\n# All of these are optional - only add what you need\npermalink: /custom-url/\ntitle: \"TOPIC\" # overrides getting title from first level-one heading (# Title) \ndescription: \"All about my topic\"  # Shows in search results and social media\n---\n\n# All about my topic\n\nEverything you needed to know about my topic.\n\n```\n\n### Blog Pages\nAdd markdown files named YYYY-MM-DD-title.md to the `_posts` directory with a level-one heading (# Title). The heading becomes the post title, and the layout is chosen automatically. The only required front matter is the date:\n\n```markdown\n---\ndate: 2024-01-01  # Required for blog posts\n---\n\n# My First Blog Post\n\nEverything you wanted to know about my first post.\n```\n\n## Additional Details\n\n### Page Types and Layouts\n\nFiles automatically get the right layout based on their location:\n1. Files named `index.md` → `home` layout\n2. Posts in `_posts/` → `post` layout\n3. Other `.md` files → `page` layout\n4. `.html` files → `default` layout\n\nYou can override any automatic layout by specifying it in front matter:\n```yaml\n---\nlayout: custom-layout\n---\n```\n\n### Page URLs (Permalinks)\n\nFor pages in the `_pages` directory:\n- If you specify a `permalink:` in the front matter, that exact URL path will be used\n- If you don't specify a permalink, Jekyll will automatically create a URL based on the filename:\n  - `_pages/about.md` becomes `/about/`\n  - `_pages/topics/specific.md` becomes `/topics/specific/`\n\nBlog posts automatically get URLs based on their filename pattern:\n`_posts/YYYY-MM-DD-title.md` becomes `/YYYY/MM/DD/title/`\n\n### Blog Index Page\nIf using blog features, the `_pages/blog.md` will list all posts:\n\nThis will create a blog index page that:\n- Lists all posts chronologically (newest first)\n- Shows each post's title, date, and first paragraph\n- Provides a link to the full post\n\n## Local Development\n\nWhile most users can rely on the free GitHub Pages infrastructure, you can optionally run Jekyll locally:\n\nSIDENOTE: Most users do not need to run Jekyll locally - GitHub Pages will automatically build and serve your site.\n\nIf you do want to run locally, install Ruby and Jekyll for your operating system:\n- macOS: `brew install ruby jekyll`\n- Ubuntu/Debian: `sudo apt install ruby-full jekyll`\n- Windows: See [Jekyll on Windows](https://jekyllrb.com/docs/installation/windows/)\n\nThen run:\n```zsh\nbundle install   # Install required gems\njekyll serve     # Start local server at http://localhost:4000\n```\n\nMore details are available at the official [Jekyll Installation Guide](https://jekyllrb.com/docs/installation/).\n\n## License\n\nReleased under [CC0](LICENSE) (\"No Rights Reserved\"). Use freely without attribution.\n\n## Author\n\nCreated by Christopher Allen ([GitHub @ChristopherA](https://github.com/ChristopherA))\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchristophera%2Fbasetheme-demosite","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fchristophera%2Fbasetheme-demosite","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchristophera%2Fbasetheme-demosite/lists"}