Empowering Innovation Through DevOps, Cloud Native, AI, and Emerging Technologies!
Ready to contribute? Follow the steps below to get started!
Make sure you have the following installed:
- Git โ Latest version
- Node.js โ Latest LTS version or newer
- Hugo โ A framework for building websites
Go to the repository and click the "Fork" button on the top right
to create a copy in your GitHub account.
After forking, use the following command to clone your forked repository:
git clone https://github.com/devopscloudjunction/website.git website && cd website
Next, install the necessary Node.js packages:
npm install
And install Hugo:
brew install hugo
Verify the Hugo installation:
hugo version
You can start the development server in one of two ways:
-
Using npm:
npm run start
-
Using Hugo:
hugo server
Visit http://localhost:1313 to view the local site.
Follow these steps to add a new blog post:
Create a new branch from the main
branch for your blog post:
git checkout -b sample-blog
Run the below command from root
directory to get ready with your blog layout.
hugo new blog/<blog-name>/index.md
Replace
<blog-name>
with a meaningful name related to your blog topic.
Alternatively, you can manually create a folder and copy the index.md
from an existing blog post, like say-hello-to-devopscloudjunction
.
Edit the index.md
file and update the fields:
- Title: Add your blog title.
- Description: Provide a brief summary of your blog.
- Image: Include an image. Use either a relevant image or the default
dcj.jpeg
located atimages/dcj.jpeg
. - Weight: Keep the weight as value 100 for your blogs, the redordering will be based on the date
For Markdown tips, check out the Markdown Cheat Sheet.
For code highlighting, refer to The Code Buzz.
Run the Hugo server to preview your blog locally:
hugo server
Check http://localhost:1313 to ensure everything looks good.
Once satisfied with your changes:
-
Commit the changes:
git add . git commit -m "Added blog: <your-blog-title>"
-
Push the branch and create a pull request:
git push origin sample-blog
-
Add reviewers to your PR, and you can preview the changes through Deploy Preview.
Once approved, your branch will be merged into the main
branch and your blog will go live on the website.
- Always include an image with your blog. If unsure, use the default image
dcj.jpeg
. - Follow proper markdown formatting and code block highlighting when necessary.