Skip to content

Latest commit

 

History

History
95 lines (66 loc) · 3.11 KB

README.md

File metadata and controls

95 lines (66 loc) · 3.11 KB

younsl.github.io

Tech blog and chart repository.

Getting started

Prerequisite

Note

Before installing the blog, You need to install hugo v0.119.0 or higher.

Install hugo using brew package manager in your local environment.

brew install hugo
hugo version

Installation

Add nostyleplease theme as a submodule using git command.

Tip

Adding the theme as a submodule allows you to easily update it in the future and keep your blog's design consistent with the latest features and fixes.

git submodule init
git submodule add https://github.com/hanwenguo/hugo-theme-nostyleplease themes/nostyleplease
git submodule update themes/nostyleplease

Theme folders like nostyleplease must be under themes/ directory for the hugo server to find it when running.

younsl.github.io
├── content
├── config.toml
├── ... more directories ...
└── themes
    └── nostyleplease

Check the submodule status.

$ git submodule status
 2cc41d38a6457d325ef0451a593ece1e00dbe60a themes/nostyleplease (heads/main)

Running hugo server

Create your blog site using the nostyleplease theme.

cd younsl.github.io
hugo server -t nostyleplease
open http://localhost:1313

If you're familiar with container environments, you can run hugo server in a container for local development. Use this dockerfile to build the image and then run the container.

# Build blog container
docker build -t hugo:dev .

# Run blog container mounting local blog directory to /app directory
cd younsl.github.io
SOURCE=$(pwd)
docker run -d --name hugo -p 1313:1313 -v ${SOURCE}:/app hugo:dev

Verify hugo container is running.

$ docker ps
CONTAINER ID   IMAGE         COMMAND                  CREATED        STATUS        PORTS                    NAMES
5fc4d6457641   hugo:latest   "hugo server -t nost…"   12 hours ago   Up 12 hours   0.0.0.0:1313->1313/tcp   hugo

Now, open your browser and go to http://localhost:1313 to view your hugo blog in real-time and start local development.

Deployment

Deployment method is github actions (beta), not classic. There is no need for any additional branches.

It is recommended to use the Standard Hugo Workflow provided by Github Pages. See my hugo deployment workflow on this repository.

Integrations

Several plugins were integrated with this blog using the partials function.

Status Integration Name Description Integration Method
In-use Google Adsense Google Ads Hugo partials
In-use Google Search Console SEO for Google Static file