Repository files navigation

Personalblog and project showcase for David Taylor (Cloud Artisan).

This site is built with:

• Hugo - A fast and modern static site generator
• Congo Theme - A powerful, lightweight theme for Hugo

1. Clone this repository:

   git clone https://github.com/cloudartisan/cloudartisan.github.io.gitcd cloudartisan.github.io

2. Install Hugo (specific version to ensure compatibility):

    go install -tags extended github.com/gohugoio/hugo@v0.149.0

   Ensure your Go bin directory (typically ~/go/bin) is in your PATH.

3. Run the local development server:

   hugo server -D

4. View the site athttp://localhost:1313/

hugo new content posts/YYYY-MM-DD-post-name.md

A new post will be created with the following template:

---title:"Post Name"date:YYYY-MM-DDT00:00:00+00:00draft:truedescription:""tags:[]categories:[]series:[]---# Post Name## Introduction<!-- Write your introduction here -->## Main Content<!-- Main content starts here -->## Conclusion<!-- Wrap up your post here -->

1. File naming: Use the formatYYYY-MM-DD-post-name.md (kebab-case)

2. Frontmatter:

   • title: Clear, descriptive title in title case
   • date: Publication date in ISO format
   • draft: Set totrue until ready to publish
   • description: 1-2 sentences summarising the post (used for SEO)
   • tags: Array of relevant keywords (use existing tags where possible)
   • categories: Optional grouping (e.g., "Tutorials", "Cloud Computing")
   • series: Optional series name if part of a multi-post series

3. Content Structure:

   • Use Markdown for content with## (H2) and### (H3) for sections
   • Store images in/static/images/YYYY/MM/ directory
   • Reference images with absolute paths (e.g.,/images/2025/04/example.png)
   • Use UK English spelling and grammar

4. Testing:

   • Preview withhugo server -D to see drafts locally
   • Drafts will not be published to the live site

hugo new content projects/project-name/index.md

Create a project directory to include additional assets like images and thumbnails.

The repository includes several maintenance scripts in thescripts/ directory:

• fix_backticks.py - Fixes inline code formatting issues in markdown files
• fix_twitter_links.py - Updates Twitter links from HTTP to HTTPS
• fix_links.py - Template for fixing various broken links

To run a script:

python3 -m venv venv                # Create virtual environment (first time only)source venv/bin/activate            # Activate virtual environmentpip3 install -r requirements.txt    # Install dependencies (first time only)python3 scripts/script_name.py      # Run the script

hugo

This will generate the static site in thepublic directory.

The site is automatically deployed to GitHub Pages using GitHub Actions when changes are pushed to the main branch. The workflow:

1. Builds the Hugo site using Hugo modules
2. Deploys the generated files to the gh-pages branch
3. GitHub Pages then serves the content from the gh-pages branch

To configure GitHub Pages:

1. Go to repository Settings > Pages
2. Set the source to "Deploy from a branch"
3. Select the "gh-pages" branch and "/" (root) folder
4. Save the settings

Note: The site uses two workflows - "Deploy Hugo site" builds the site, and "pages-build-deployment" handles the GitHub Pages publishing.

Shield:

My blog content, posts, etc are licensed under aCreative Commons Attribution-ShareAlike 4.0 International License.