https://github.com/tomcam/least-github-pages
The least you need to know about GitHub Pages is laser-focused on one thing: showing how to get a working informational website up and running as fast as possible using GitHub Pages, using only the GitHub website.
https://github.com/tomcam/least-github-pages
github-pages github-pages-website
Last synced: about 1 month ago
JSON representation
The least you need to know about GitHub Pages is laser-focused on one thing: showing how to get a working informational website up and running as fast as possible using GitHub Pages, using only the GitHub website.
- Host: GitHub
- URL: https://github.com/tomcam/least-github-pages
- Owner: tomcam
- License: gpl-3.0
- Created: 2019-02-12T01:49:26.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2023-12-12T21:44:25.000Z (about 2 years ago)
- Last Synced: 2025-01-21T23:48:27.818Z (about 1 year ago)
- Topics: github-pages, github-pages-website
- Homepage: https://tomcam.github.io/least-github-pages/
- Size: 12.2 MB
- Stars: 49
- Watchers: 3
- Forks: 41
- Open Issues: 0
-
Metadata Files:
- Readme: docs/README.md
- License: LICENSE
Awesome Lists containing this project
README
# The Least You Need to Know About GitHub Pages
**What this guide is for:** This guide is laser-focused on one thing: showing how to get a working informational website up and running as fast
as possible using [GitHub Pages](https://pages.github.com), using only the GitHub website. *Informational website* is an informal term meaning that the emphasis is on
function (structured text with simple formatting, links, images) and not form (intricate page design). It goes step by step from the very beginning
and assumes very little knowledge on your part.
You don't need to learn command-line programs like Git, or install anything
on your own computer. Everything taught here does apply to advanced use patterns when you get more experienced.
GitHub Pages is free if your repository (file storage area) is public.
**Ways to view this site**
* [Github Pages](https://tomcam.github.io/least-github-pages/)
* Directly on [Github](https://github.com/tomcam/least-github-pages/)
If you were pointed here by an employer or well-meaning friend and aren't quite sure why,
you can find plenty of reasons in [Why Use GitHub Pages?](why-use-github-pages.md)
**What you can get out of this guide:** If you follow through the steps in this guide you'll have a small website demonstrating everything you need to put up an attractive, easy to maintain site using words, links, and images.
Not covered are advanced topics such as using Git on the command line, custom themes, SEO, version control,
and advanced features of GitHub-flavored Markdown.
**If you find problems**
If there's something missing, or you detect an error, please feel free to [file an issue](https://github.com/tomcam/least-github-pages/issues)
or just email at `tomcampbell@gmail.com`.
## Table of contents
This short GitHub Pages tutorial discusses:
* [Intended audience](#intended-audience)
* [Create a GitHub Account](creating-github-account.md)
* [Create a GitHub repository](creating-github-repository.md)
* [Edit the main GitHub Pages README file in /docs/README.md](github-pages-create-readme.md)
* [Enable GitHub Pages](enable-github-pages.md) so you can create and publish a formatted website
* [Create a web page on GitHub](create-page-github.md) using Markdown
* [GitHub Pages directory and file usage](github-pages-directory-file-usage.md)
* [Create Markdown links to other pages on your own site](markdown-links.md)
* [Headers in Markdown](markdown-headers.md)
* [Create Markdown links to other sites](markdown-links-to-other-sites.md)
* [Create Markdown links to the interior of a page](markdown-link-page-interior.md)
* [Add an assets directory to your GitHub Pages site](adding-assets-directory-github-pages.md)
* [Change the appearance of your GitHub Pages site using Jekyll themes](github-pages-jekyll-themes.md)
* [Add images to your GitHub Pages site](adding-images-github-pages-site.md)
* [Determine your GitHub Pages URL](github-pages-url.md)
* [Privacy warning](privacy-warning.md)
* [Add a GitHub Pages preview link to your README.md](add-github-pages-preview.md)
## Intended audience
GitHub Pages uses [Jekyll](https://jekyllrb.com), a publishing system based on the Ruby programming language. The Jekyll documentation is excellent, especially if you already know Jekyll, program in Ruby, and have both Ruby and Jekyll installed on your local computer. The GitHub Pages documentation is comprehensive and excellent--if you're already a Jekyll expert.
[The Least You Need to Know About GitHub Pages](./) is designed for people who don't happen to know Jekyll already but who need to get up to speed in GitHub Pages quickly to get a job done *now*. It tells you not only *what* to do step by step,
but also briefly explains *why* you're doing it.
You probably don't want to use GitHub Pages on sites that require complex, individual formatting on a per-page basis.
GitHub Pages uses Markdown, which has some limited formatting information but not a lot.
GitHub Pages then uses Jekyll to turn that Markdown into HTML, based on the Jekyll theme you've chosen. Generally speaking this approach is
absolutely ideal for blogs, technical documents and instructional materials that require versioning and collaboration, where the
main work product is words and pictures. It is not a good fit for things like boutique pages, restaurant menu sites, consumer product sites, and so on where
custom formatting is the norm.
### Advantages to using GitHub Pages
Still wondering whether to use GitHub Pages? See [Advantages to using GitHub Pages to generate static sites](github-pages-advantages.md)
### Disadvantages to using GitHub Pages
If you want to understand why GitHub pages may not suit your project, see [When to avoid GitHub pages](github-pages-disadvantages.md).
[Next page](creating-github-account.md)