cd relic-project
git init
git add .
git commit -m "initial site setup"
git remote add origin https://github.com/YOUR-USERNAME/relic-project.git
git push -u origin mainReplace
YOUR-USERNAMEwith your actual GitHub username.
- Go to your repo on github.com
- Click Settings → Pages
- Under "Source", select Deploy from a branch
- Choose main branch, / (root) folder
- Click Save
- Wait 1-2 minutes — your site will be live at:
https://YOUR-USERNAME.github.io/relic-project/
Decap CMS needs an OAuth provider to let you log in with GitHub. Netlify provides this for free.
- Go to netlify.com and sign up (free)
- Click Add new site → Import an existing project
- Connect your GitHub account and select the
relic-projectrepo - Deploy settings:
- Build command:
jekyll build - Publish directory:
_site
- Build command:
- Click Deploy
Note: You don't need to use Netlify for hosting — you're only using it for OAuth. Your site stays on GitHub Pages.
- In Netlify, go to Site configuration → Identity
- Click Enable Identity
- Under Registration, select Invite only
- Under External providers, click Add provider → GitHub
- Leave defaults and click Enable GitHub
- Go to Services → Git Gateway → Enable Git Gateway
This is already done! The admin/index.html file loads Decap CMS from the CDN.
But you also need to add the Netlify Identity widget to your main site. Add this script tag to your _layouts/default.html in the <head>:
<script src="https://identity.netlify.com/v1/netlify-identity-widget.js"></script>And add this before </body>:
<script>
if (window.netlifyIdentity) {
window.netlifyIdentity.on("init", user => {
if (!user) {
window.netlifyIdentity.on("login", () => {
document.location.href = "/admin/";
});
}
});
}
</script>- In Netlify dashboard → Identity → Invite users
- Enter your email address
- Check your email and accept the invitation
- Set a password
Go to:
https://YOUR-USERNAME.github.io/relic-project/admin/
Log in with the email/password you set up in Step 6. You'll see a GUI where you can edit:
- Hero title
- Authors list
- Abstract text
- Links
- Method description
- BibTeX
Any changes you make will be committed directly to your GitHub repo, and GitHub Pages will rebuild automatically.
relic-project/
├── _config.yml # Jekyll configuration
├── _layouts/
│ └── default.html # HTML template with all CSS
├── _data/
│ └── site_content.yml # ← Decap CMS edits THIS file
├── index.html # Main page (reads from site_content.yml)
├── admin/
│ ├── index.html # Decap CMS entry point
│ └── config.yml # Decap CMS config (defines editable fields)
├── assets/
│ ├── images/ # Put your images here
│ └── videos/ # Put your videos here
├── Gemfile # Ruby dependencies
└── README.md # This file
- You open
/admin/and edit content in the GUI - Decap CMS saves changes to
_data/site_content.ymlin your GitHub repo - GitHub Pages detects the commit and rebuilds the Jekyll site
- Jekyll reads
site_content.ymland injects the data intoindex.html - Your site updates automatically in 1-2 minutes
- To add images: use the media upload button in the CMS
- To edit HTML/CSS: edit
_layouts/default.htmldirectly on GitHub - To add new sections: edit both
admin/config.yml(add fields) andindex.html(add template code)