Simplest GitHub Page
Test of simplest GitHub page, leveraging Jekyll without Jekyll.
View at https://christophera.github.io/simplest-github-page/
Repo at https://github.com/ChristopherA/simplest-github-page/
Goals
- Without using Jekyll, Ruby or Gem, leverage the various files that allow you to use markdown directly within github pages.
- Pages should largely look the same when rendered from the GitHub repo page and from the git
- Leverage the default Jekyll Primer theme’s CSS without the using the full theme.
- Support internal anchor link tags
Using This
Notes
- This technique will force Github to default to the CSS used by the Primer Theme, which is is the default Github theme if you do not select a theme, however, note that this theme is not among GitHub’s standard theme choices, so you can’t return to it if you pick a different theme.
- I’ve not been able to get the
_posts
feature to work without using Jekyll itself. The supposedly should work, but doesn’t.
- You can create other
_layouts/
templates, and have pages use them by adding this yaml frontmatter to the top of the page:
---
layout: templatename
---
- You can have pages that will not be rendered as web pages by adding this yaml frontmatter to the top of the page:
Displays correctly both Web View and in GitHub View
- Github will render raw URLs as links, but you must use proper markdown construction
[linkname](link)
for URLs to display propery in the Web View.
- If you do a relative link to a markdown file without the extension, it will be rendered in html correctly, for example relative ./sample. Unfortunately, when rendered in Github the relative link will give a 404 error. To preserve compatiblity of both, if use use the
.md
extension in the relative link — it will render correctly in both html and gihub and both will function as links to the correct place, for example see ./sample.md. You do not need to do this with /
which will render README.md
as index.html
Displays correctly in Web View, but look different (but is acceptable) in GitHub View
Box Header
Box body text, such as the quick brown fox jumped over the lazy dog.
Displays correctly in Web View, but on in GitHub View
- You can display a github avatar in the Web View but is ugly in the Github View.