update blogs

Author: Jason-cs18

content/posts/2025_11_21_building_a_blog_with_hugo.md

@@ -0,0 +1,260 @@
+---
+title: "Creating a blog with Hugo and GitHub Pages"
+date: 2025-11-21
+draft: false
+ShowToc: true
+author: "Jason"
+tags: ["writing"]
+---
+
+> _A hands-on guide to creating a blog with Hugo and GitHub Pages._
+
+![](imgs/blog_hugo_github.png)
+
+## Prerequisites
+
+- A [GitHub](https://github.com/) account
+- Installed [Microsoft Visual Studio Code](https://code.visualstudio.com/download)
+- Installed [Git](https://git-scm.com/downloads)
+- Installed [Snap](https://snapcraft.io/docs/installing-snap-on-ubuntu)
+
+If you are not familiar with Git, you can refer to [the simple guide](https://rogerdudler.github.io/git-guide/).
+
+## Installation
+
+### Install Hugo
+
+```bash
+sudo snap install hugo
+hugo version # test installation
+```
+
+### Install PaperMod Theme
+
+```bash
+mkdir -p homepages && cd homepages
+hugo new site mywebsite --format=yaml && cd mywebsite
+git init
+git submodule add --depth=1 https://github.com/adityatelange/hugo-PaperMod.git themes/PaperMod
+echo "theme: PaperMod" >> hugo.yaml
+```
+
+After the installation, you should have a directory structure like this:
+```bash
+.
+└── mywebsite
+    ├── archetypes
+    ├── assets
+    ├── content # blog posts
+    ├── data
+    ├── hugo.yaml # configuration file
+    ├── i18n
+    ├── layouts
+    ├── public
+    ├── static
+    └── themes
+```
+You can test the blog locally by running:
+```bash
+# in the mywebsite directory
+hugo server -D
+```
+## Create the first blog locally
+Create a new blog post:
+```bash
+hugo new about.md # create content/about.md
+```
+Edit the content of the file:
+```bash
+---
+title: "About"
+date: 2025-11-22
+draft: false
+ShowToc: true
+author: "Jason"
+tags: ["about"]
+---
+Hi! I am a new blog post.
+```
+
+Edit the configuration file:
+```bash
+baseURL: https://AgentScaleLab.github.io
+languageCode: en-us
+title: Jason'Log
+theme: PaperMod
+params:
+  defaultTheme: dark
+  ShowReadingTime: true
+  ShowAllPagesInArchive: true
+  ShowWordCount: true
+  homeInfoParams:
+    Title: "\U0001F44B Welcome to Jason'Log"
+    Content: >-
+      Hi, this is Jason. I'm documenting my learning notes in this blog since 2025.
+  socialIcons:
+    - name: email
+      url: 'xxx@outlook.com'
+    - name: github
+      url: 'https://github.com/AgentScaleLab'
+menu:
+  main:
+  - identifier: about
+    name: About
+    url: /
+    weight: 20
+
+```
+
+Build the blog locally:
+```bash
+hugo server -D
+```
+If you want to organize your blogs in folders, following the steps below:
+
+Organize your blog posts in folders:
+```bash
+content/
+├── posts
+├── projects
+└── tags
+```
+Modify the configuration file:
+```bash
+# hugo.yaml
+...
+menu:
+  main:
+  - identifier: posts
+    name: Blog
+    url: /posts/
+    weight: 20
+  - identifier: projects
+    name: Project
+    url: /projects/
+    weight: 20
+  - identifier: tags
+    name: Tags
+    url: /tags/
+    weight: 20
+
+```
+
+
+## Deploy to GitHub Pages
+
+Create a new repository named **YOUR-NAME-ON-GITHUB.github.io** on GitHub.
+
+Link the local repository to GitHub:
+```bash
+cd mywebsite
+git remote add origin git@github.com:AgentScaleLab/AgentScaleLab.github.io
+```
+Push the local repository to GitHub:
+```bash
+git status
+git add .
+git commit -m "first commit"
+git push -u origin main
+```
+
+Change the settings of the repository on GitHub:
+1. Enable "Read and write permissions" under "Actions" -> "General".
+2. Under "Pages", set the source to "Deploy from a branch" and select "Github Actions" as the workflow.
+3. Search and click "hugo" template workflow.
+4. Under "Actions", click "Run workflow"."
+
+![](https://keanteng.github.io/home/docs/2023_04_09-creating-a-website-with-hugo--papermode/images/git_action.png)
+
+If the deployment is not successful, you can modify the workflow file in the **.github/workflows** folder. The template workflow file is as follows:
+
+```yaml
+# Sample workflow for building and deploying a Hugo site to GitHub Pages
+name: Deploy Hugo site to Pages
+
+on:
+  # Runs on pushes targeting the default branch
+  push:
+    branches: ["master"]
+
+  # Allows you to run this workflow manually from the Actions tab
+  workflow_dispatch:
+
+# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+# Allow only one concurrent deployment, skipping runs queued between the run in-progress and latest queued.
+# However, do NOT cancel in-progress runs as we want to allow these production deployments to complete.
+concurrency:
+  group: "pages"
+  cancel-in-progress: false
+
+# Default to bash
+defaults:
+  run:
+    shell: bash
+
+jobs:
+  # Build job
+  build:
+    runs-on: ubuntu-latest
+    env:
+      HUGO_VERSION: 0.146.0
+    steps:
+      - name: Install Hugo CLI
+        run: |
+          wget -O ${{ runner.temp }}/hugo.deb https://github.com/gohugoio/hugo/releases/download/v${HUGO_VERSION}/hugo_extended_${HUGO_VERSION}_linux-amd64.deb \
+          && sudo dpkg -i ${{ runner.temp }}/hugo.deb
+      - name: Install Dart Sass
+        run: sudo snap install dart-sass
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          submodules: recursive
+      - name: Setup Pages
+        id: pages
+        uses: actions/configure-pages@v5
+      - name: Install Node.js dependencies
+        run: "[[ -f package-lock.json || -f npm-shrinkwrap.json ]] && npm ci || true"
+      - name: Build with Hugo
+        env:
+          HUGO_CACHEDIR: ${{ runner.temp }}/hugo_cache
+          HUGO_ENVIRONMENT: production
+        run: |
+          hugo \
+            --minify \
+            --baseURL "${{ steps.pages.outputs.base_url }}/"
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: ./public
+
+  # Deployment job
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    needs: build
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4
+
+```
+
+## Update the blog posts
+```bash
+cd mywebsite && git pull # make sure the local repository is up to date
+# modify the content in the content/ folder
+git status # check the changes
+git add .
+git commit -m "update blog posts"
+git push origin main
+```
+
+## Notes
+1. Hugo only shows the articles that are published before the current date.

content/posts/2025_11_21_building_a_blog_with_hugo/imgs/blog_hugo_github.png

@@ -135,10 +135,12 @@ <h2 class="entry-hint-parent">Creating a blog with Hugo and GitHub Pages
     </h2>
   </header>
   <div class="entry-content">
-    <p>Hi! I am a new blog post.
-</p>
+    <p> A hands-on guide to creating a blog with Hugo and GitHub Pages.
+Prerequisites A GitHub account Installed Microsoft Visual Studio Code Installed Git Installed Snap If you are not familiar with Git, you can refer to the simple guide.
+Installation Install Hugo sudo snap install hugo hugo version # test installation Install PaperMod Theme mkdir -p homepages &amp;&amp; cd homepages hugo new site mywebsite --format=yaml &amp;&amp; cd mywebsite git init git submodule add --depth=1 https://github.com/adityatelange/hugo-PaperMod.git themes/PaperMod echo &#34;theme: PaperMod&#34; &gt;&gt; hugo.yaml After the installation, you should have a directory structure like this:
+...</p>
   </div>
-  <footer class="entry-footer"><span title='2025-11-21 00:00:00 +0000 UTC'>November 21, 2025</span>&nbsp;·&nbsp;<span>1 min</span>&nbsp;·&nbsp;<span>7 words</span>&nbsp;·&nbsp;<span>Jason</span></footer>
+  <footer class="entry-footer"><span title='2025-11-21 00:00:00 +0000 UTC'>November 21, 2025</span>&nbsp;·&nbsp;<span>4 min</span>&nbsp;·&nbsp;<span>729 words</span>&nbsp;·&nbsp;<span>Jason</span></footer>
   <a class="entry-link" aria-label="post link to Creating a blog with Hugo and GitHub Pages" href="http://localhost:1313/posts/2025_11_21_building_a_blog_with_hugo/"></a>
 </article>
     </main>

content/posts/2025_11_21_building_a_blog_with_hugo/imgs/blog_hugo_github_page.png

@@ -34,7 +34,29 @@
       <link>http://localhost:1313/posts/2025_11_21_building_a_blog_with_hugo/</link>
       <pubDate>Fri, 21 Nov 2025 00:00:00 +0000</pubDate>
       <guid>http://localhost:1313/posts/2025_11_21_building_a_blog_with_hugo/</guid>
-      <description>&lt;p&gt;Hi! I am a new blog post.&lt;/p&gt;</description>
+      <description>&lt;blockquote&gt;
+&lt;p&gt;&lt;em&gt;A hands-on guide to creating a blog with Hugo and GitHub Pages.&lt;/em&gt;&lt;/p&gt;
+&lt;/blockquote&gt;
+&lt;p&gt;&lt;img loading=&#34;lazy&#34; src=&#34;http://localhost:1313/posts/2025_11_21_building_a_blog_with_hugo/imgs/blog_hugo_github.png&#34;&gt;&lt;/p&gt;
+&lt;h2 id=&#34;prerequisites&#34;&gt;Prerequisites&lt;/h2&gt;
+&lt;ul&gt;
+&lt;li&gt;A &lt;a href=&#34;https://github.com/&#34;&gt;GitHub&lt;/a&gt; account&lt;/li&gt;
+&lt;li&gt;Installed &lt;a href=&#34;https://code.visualstudio.com/download&#34;&gt;Microsoft Visual Studio Code&lt;/a&gt;&lt;/li&gt;
+&lt;li&gt;Installed &lt;a href=&#34;https://git-scm.com/downloads&#34;&gt;Git&lt;/a&gt;&lt;/li&gt;
+&lt;li&gt;Installed &lt;a href=&#34;https://snapcraft.io/docs/installing-snap-on-ubuntu&#34;&gt;Snap&lt;/a&gt;&lt;/li&gt;
+&lt;/ul&gt;
+&lt;p&gt;If you are not familiar with Git, you can refer to &lt;a href=&#34;https://rogerdudler.github.io/git-guide/&#34;&gt;the simple guide&lt;/a&gt;.&lt;/p&gt;
+&lt;h2 id=&#34;installation&#34;&gt;Installation&lt;/h2&gt;
+&lt;h3 id=&#34;install-hugo&#34;&gt;Install Hugo&lt;/h3&gt;
+&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;&#34;&gt;&lt;code class=&#34;language-bash&#34; data-lang=&#34;bash&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;sudo snap install hugo
+&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;hugo version &lt;span style=&#34;color:#75715e&#34;&gt;# test installation&lt;/span&gt;
+&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;h3 id=&#34;install-papermod-theme&#34;&gt;Install PaperMod Theme&lt;/h3&gt;
+&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;&#34;&gt;&lt;code class=&#34;language-bash&#34; data-lang=&#34;bash&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;mkdir -p homepages &lt;span style=&#34;color:#f92672&#34;&gt;&amp;amp;&amp;amp;&lt;/span&gt; cd homepages
+&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;hugo new site mywebsite --format&lt;span style=&#34;color:#f92672&#34;&gt;=&lt;/span&gt;yaml &lt;span style=&#34;color:#f92672&#34;&gt;&amp;amp;&amp;amp;&lt;/span&gt; cd mywebsite
+&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;git init
+&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;git submodule add --depth&lt;span style=&#34;color:#f92672&#34;&gt;=&lt;/span&gt;&lt;span style=&#34;color:#ae81ff&#34;&gt;1&lt;/span&gt; https://github.com/adityatelange/hugo-PaperMod.git themes/PaperMod
+&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;echo &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;theme: PaperMod&amp;#34;&lt;/span&gt; &amp;gt;&amp;gt; hugo.yaml
+&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;After the installation, you should have a directory structure like this:&lt;/p&gt;</description>
     </item>
   </channel>
 </rss>