Table Of ContentMastering GitHub Pages
Mastering Computer Science
Series Editor: Sufyan bin Uzayr
Mastering GitHub Pages: A Beginner’s Guide
Sumanna Kaul and Shahryar Raz
Mastering Unity: A Beginner’s Guide
Divya Sachdeva and Aruqqa Khateib
Mastering Unreal Engine: A Beginner’s Guide
Divya Sachdeva and Aruqqa Khateib
Mastering Java: A Beginner’s Guide
Divya Sachdeva and Natalya Ustukpayeva
Mastering Python for Web: A Beginner’s Guide
Mathew Rooney and Madina Karybzhanova
Mastering MySQL for Web: A Beginner’s Guide
Mathew Rooney and Madina Karybzhanova
For more information about this series, please visit: https://
www.routledge.com/Mastering-Computer-Science/
book-series/MCS
The “Mastering Computer Science” series of books are
authored by the Zeba Academy team members, led by
Sufyan bin Uzayr.
Zeba Academy is an EdTech venture that develops
courses and content for learners primarily in STEM
fields, and offers education consulting to Universities and
Institutions worldwide. For more info, please visit https://
zeba.academy
Mastering GitHub Pages
A Beginner’s Guide
Edited by Sufyan bin Uzayr
First edition published 2022
by CRC Press
6000 Broken Sound Parkway NW, Suite 300, Boca Raton, FL 33487-2742
and by CRC Press
2 Park Square, Milton Park, Abingdon, Oxon, OX14 4RN
CRC Press is an imprint of Taylor & Francis Group, LLC
© 2022 Sufyan bin Uzayr
Reasonable efforts have been made to publish reliable data and information, but the
author and publisher cannot assume responsibility for the validity of all materials or
the consequences of their use. The authors and publishers have attempted to trace
the copyright holders of all material reproduced in this publication and apologize to
copyright holders if permission to publish in this form has not been obtained. If any
copyright material has not been acknowledged please write and let us know so we may
rectify in any future reprint.
Except as permitted under U.S. Copyright Law, no part of this book may be reprinted,
reproduced, transmitted, or utilized in any form by any electronic, mechanical, or other
means, now known or hereafter invented, including photocopying, microfilming, and
recording, or in any information storage or retrieval system, without written permission
from the publishers.
For permission to photocopy or use material electronically from this work, access www.
copyright.com or contact the Copyright Clearance Center, Inc. (CCC), 222 Rosewood
Drive, Danvers, MA 01923, 978-750-8400. For works that are not available on CCC
please contact [email protected]
Trademark Notice: Product or corporate names may be trademarks or registered
trademarks and are used only for identification and explanation without intent to
infringe.
ISBN: 9781032149837 (hbk)
ISBN: 9781032149783 (pbk)
ISBN: 9781003242055 (ebk)
DOI: 10.1201/9781003242055
Typeset in Minion
KnowledgeWorks Global Ltd.
Contents
About the Editor, xi
Chapter 1 ◾ I ntroduction to Git and GitHub 1
WHAT IS GIT 1
Why Should We Use Git? 4
Installation 6
GitHub Desktop 7
Git on Windows 7
Install Git on Mac 8
Installing Git Using an Installer 8
Installing Git Using Homebrew 9
Installing Git on Linux 9
Debian/Ubuntu 9
Fedora 10
Some Elementary Functions 10
Creating Branches 11
Making Changes and Making Commits 12
Pushing Your Changes to the Remote 12
v
vi ◾ Contents
Opening a Pull Request 13
Collaborating 14
Merging into Master 15
The Commands 15
WHAT IS VERSION CONTROL 17
WHAT IS GITHUB? 28
SSH Access 33
Your Avatar 34
Email Addresses 35
Two-Factor Authentication 35
History of GitHub 36
Acquired by Microsoft 39
Mascot 41
How to Use GitHub 43
How to Create a Repository on GitHub? 44
Creating Branches 45
Making Commits 46
Pull Command 47
Merge Command 48
Cloning as well as Forking GitHub
Repository 48
Different Types of Accounts 49
Personal User Accounts 49
Organization Accounts 50
Enterprise Accounts 51
Contents ◾ vii
Chapter 2 ◾ W hat Are GitHub Pages? 53
WHAT ARE GITHUB PAGES? 53
BASICS OF GITHUB PAGES 61
Static and Dynamic Websites 63
Static Website 63
Dynamic Website 65
Types of GitHub Pages Sites 71
Publication of Sources for GitHub Pages Sites 72
Generation of Static Sites 73
Usage Limits 74
Prohibition on Usage 75
MIME Types on GitHub Pages 76
Chapter 3 ◾ G etting Started with GitHub
Pages 81
CREATING GITHUB PAGES SITE 82
CONFIGURING A PUBLISHING SOURCE
FOR YOUR GITHUB PAGES SITE 85
Managing the Publication of GitHub Pages
Site for Your Organization 85
Unpublishing a GitHub Pages Sites 86
Unpublishing a Project Site 87
CHANGING THE VISIBILITY OF YOUR
GITHUB PAGES SITES 88
Securing Your GitHub Pages Site with HTTPS 90
Regarding HTTPS 90
viii ◾ Contents
COOKIES 90
Cookie Tossing in a Subdomain 91
Protection from Cookie Tossing 93
Cookie Path Workaround 95
Cookie Escape 96
Cookie Overflow 99
ADDING THEMES 101
Theme Chooser 102
Chapter 4 ◾ J ekyll and GitHub Pages 105
INTRODUCTION TO JEKYLL 106
Prerequisites 106
Installation 107
TESTING YOUR GITHUB PAGES SITE
LOCALLY USING JEKYLL 112
TROUBLESHOOTING 113
Installation Troubles 113
Unable to Find a JavaScript Runtime 119
Problems while Running Jekyll 119
macOSPermalink 119
Debian/Ubuntu 119
Base-URL Problems 119
Updating the Gems for Your GitHub
Pages 120
Configuration Problems 120
Markup Problems 122
Contents ◾ ix
Chapter 5 ◾ C onfiguring a Custom Domain 125
WHAT IS A CUSTOM DOMAIN? 125
Features of a Domain 126
Supported Custom Domains 127
Use of a Subdomain for Your GitHub Pages Site 128
www Subdomains 128
Custom Subdomains 128
Using Apex Domains for Your GitHub Pages Site 128
Updating Custom Domains When Your
GitHub Pages Site Gets Disabled 129
MANAGING A CUSTOM DOMAIN FOR
GITHUB PAGES SITE 130
Configuring a Subdomain 130
Configuring an Apex Domain 132
Configuring an Apex Domain as well as the
www Subdomain Variant 136
Eliminating a Custom Domain 137
TROUBLESHOOTING CUSTOM DOMAINS
AS WELL AS GITHUB PAGES 137
CNAME Errors 138
DNS Misconfiguration 139
HTTPS Errors 140
URL Formatting on Linux 140
Browser Cache 140
APPENDIX, 143
INDEX, 147
