Table of contents
The Idea with this repository, is to have an easy an 'automated' setup of a blog on github pages by following some easy instructions.
You'll need to setup several steps manually (sorry, I can't do that for you), but once done, each time you publish a new article (markdown, asciidoc), the blog will be redeployed showing your new one.
Blog will be using:
Fork this repository to your github account, if this is your first 'blog', name it username.github.io
if not, it will be published as username.github.io/repository
Clone the resulting repository to your system, for example:
git clone https://github.com/iranzo/blog-o-matic.git
master
branch that will contain the code that we'll be using for updating the website.git checkout master
(should be the default)Edit new articles in content/
based on the one already provided.
As of this step, your repository should be already published on https://githubusername.github.io/ with the 'sample' content
You're ready to write a new article, use 'welcome.md' as an example so that you keep useful headers like category, tags, author, title, publish date, etc (YAML preamble) and save it as 'yourdesiredname.md'.
Once you've written your new article in 'content' folder, perform:
## Add file to repository
git add content/new-article-filename
## Add file to commit
git commit -m "My new article"
## Upload changes to github
git push
After some seconds, Git Hub Actions will start showing that a new build is in progress, and once it finishes successfully, the resulting webpage will be available via your username.github.io
domain.
peru.yaml
is set to use next
branch of Elegant theme for pelican, as this setup uses pelican 4.0 and current 'master' doesn't work for it (feed slugs related)
YOURURL/sitemap.xml
can be submittedpelicanconf.py
to match the value you received, in the line that says:CLAIM_GOOGLE = 'XX'
pelicanconf.py
to match the value you received, in the line that says:
CLAIM_BING = 'XX'
pelicanconf.py
to customize your blog name, your name, twitter handle, google analytics ID or others, please do check Pelican-Elegant documentation for more information on what can be done.