Goodways IT Team Blog Content Guide
This guide explains how to add and manage content on our technical blog. It covers blog posts, service pages, and project case studies, with a focus on multilingual content.
Adding Blog Posts
Standard Blog Posts
For regular blog posts in the default language (English), create a new markdown file in the _posts
directory:
- Name the file following this format:
YYYY-MM-DD-title-with-hyphens.md
- Add the required front matter:
---
layout: post
title: "Your Post Title"
excerpt: "A brief description of your post (appears in listings)"
date: YYYY-MM-DD HH:MM:SS +0800
categories: [Category1, Category2]
tags: [tag1, tag2, tag3]
image: /assets/images/posts/image-name.jpg # Optional featured image
---
- Write your post content in Markdown below the front matter
Multilingual Blog Posts
For posts in multiple languages, you need to create separate files for each language in their respective directories:
- English posts go in
_i18n/en/_posts/
- Chinese posts go in
_i18n/zh/_posts/
- Japanese posts go in
_i18n/ja/_posts/
The file naming should be identical across all language directories. For example:
- English:
_i18n/en/_posts/2025-05-21-oracle-high-availability.md
- Chinese:
_i18n/zh/_posts/2025-05-21-oracle-high-availability.md
- Japanese:
_i18n/ja/_posts/2025-05-21-oracle-high-availability.md
This ensures that the multilingual plugin connects these as translations of the same post.
Adding Service Pages
Service pages describe your team’s expertise and service offerings:
- Create a new markdown file in the
_services
directory - Add front matter:
---
layout: page
title: "Service Title"
description: "Brief description of the service"
excerpt: "Shorter description for service cards"
icon: database # Font Awesome icon name (without fa-)
order: 1 # Display order (lower numbers appear first)
---
- Write your service description in Markdown below the front matter
Multilingual Service Pages
For multilingual service pages, create the files in the appropriate language folders:
- English:
_i18n/en/_services/service-name.md
- Chinese:
_i18n/zh/_services/service-name.md
- Japanese:
_i18n/ja/_services/service-name.md
Adding Project Case Studies
Project case studies showcase your team’s successful implementations:
- Create a new markdown file in the
_projects
directory - Add front matter:
---
layout: page
title: "Project Title"
description: "Brief description of the project"
excerpt: "Shorter description for project cards"
order: 1 # Display order (lower numbers appear first)
---
- Write your project case study in Markdown below the front matter
Working with Images
- Store images in the
assets/images
directory - For blog post images, use the
assets/images/posts
subdirectory - For service and project images, use
assets/images/services
andassets/images/projects
- Reference images in content using the relative URL:

Managing Translations
UI Translations
Note: The blog is currently available in English only.
All UI text elements are hard-coded in English in the respective template files. If you need to modify a UI text element, locate the appropriate template file in _includes
or _layouts
directories and directly edit the text.
Publishing Workflow
- Write content locally in markdown files
- Test locally using
bundle exec jekyll serve
- Commit changes to Git and push to GitHub repository
- GitHub Actions will automatically build and deploy the site
Markdown Tips
Code Blocks
For code snippets, use triple backticks with the language specified:
```sql
SELECT * FROM employees WHERE department_id = 10;
### Tables
Create tables using pipe syntax:
| Header 1 | Header 2 | |———-|———-| | Cell 1 | Cell 2 | | Cell 3 | Cell 4 | ```
Links
Create links with this syntax: [Link text](URL)
For internal links, use relative paths: [About Us](/about/)
SEO Best Practices
- Use descriptive, keyword-rich titles
- Write compelling meta descriptions (the
excerpt
field) - Use proper heading hierarchy (H1, H2, H3)
- Include relevant categories and tags
- Use descriptive alt text for images
Need Help?
If you have questions about managing content on the blog, contact the Goodways IT Team webmaster.