log terms and new hugo site
![](https://cdn.iconscout.com/icon/premium/png-512-thumb/bamboo-10891904-8725953.png?f=webp&w=32)
Search the right term for new blog on GitHub
intro
The term log might sound familiar to some people. Long time before computer era, a form of log entry record-keeping, that was used since the first captains sailed Earth’s seas in ancient history, is known as Captain’s log, which records what was happening on a mission and to record historical facts for future generations 1. In computing context a log is the automatically produced and time-stamped documentation of events relevant to a particular system, where virtually all software applications and systems produce log files 2.
Then related to inventory, there is a log tracks the movement of commodity, including materials and goods, by code, where it records movement of full cases and units, which is known a inventory log 3. Similar to commodity, there is patient log, which records detailed information about clinical encounter with patient 4. For materials as given in a course, there is lecture log that records short description of the material covered in each lecture 5. Even the last three examples of logs given are in computer era, they exist before the time when hard copy forms still be used.
Previous examples are intended for private use or at least institutional use. Then with the internet and its spirits 6, other types of logs arise such as blog, vlog, slog 7 and plog 8, which stand for weblog, video blog, sound log, and photoblog. Notice that the second is not sound blog, sound log, which is the recorded audio file of a blog post.
I would like to make the log, as much as possible, in plain text with additional features if necessary, e.g. LaTeX with MathJax or KaTeX, diagrams with Mermaid, formatted text with Markdown, sheet music with abcjs, molecules visualization with 3Dmol.js, charts with Chart.js, and others with HTML.
new github pages
In order to implement the log a repository, whose name is nou
or notes on unstructured, is created, cloned, updated, and set up with workflow. Following are the steps and related sub-steps to create new GitHub Pages from a new repository.
create new repository
- Visit https://github.com/new.
- It might be required to login first.
- Fill repository name, e.g. nou.
- Change until it is available.
- Write description, e.g. notes on unstructured.
- Choose Public.
- Check Add a README file.
- Add .gitignore, choose any template, e.g Go.
- Choose appropriate license, e.g. MIT License.
- Click the green button, Create repository, at bottom right.
edit .gitignore
- Visit https://github.com/dudung/nou, if not redirected automatically.
- Notice that
dudung
is the GitHub username in this example. - Click
.gitignore
file. - Edit the file, click 🖉 icon.
- Erase all lines.
- Add following lines
# shortcuts
cmd.lnk
# folders
public
- Click green button, Commit changes…, on top right.
- Click green button, Commit changes, on bottom right.
- Visit the repository page, e.g. https://github.com/dudung/nou.
clone repository to local folder
- On Windows, open File Explorer, with ⊞ + E.
- Navigate to drive or folder where
nou
repository will be cloned. - Right click with mouse to open context menu, choose Show more options.
- Choose Open Git Bash here.
- Type
git clone https://github.com/dudung/nou nou
and press Enter. - Type
cd nou
and press Enter.
create cmd shortcut
- On Windows, open
nou
folder using File Explorer. - Right click with mouse to open context menu, choose New, then Shortcut.
- Type cmd.
- Click Next button, on bottom right.
- Rename it from cmd.exe to cmd.
- Click Finish button, on bottom right.
- Right click on new created icon, cmd, choose Properties.
- Delete value on Start in field.
- Click OK button, on the bottom.
copy files from previous repository
- Visit https://github.com/dudung/to.
- Copy
assets\css
and its content tonou
. - Copy
layouts
and all its content tonou
. - Copy
themes
and all its content tonou
. - Copy
hugo.toml
tonou
. - Copy
content/authors
and its content tonou
. - Copy
content/about
and its contentnou
and modify what necessary. - Create
content/posts
and copy some posts.
run hugo
- Click
cmd
onnou
. - Edit
hugo.toml
by modifying following lines
baseURL = 'https://dudung.github.io/nou'
title = 'nou'
- Type
hugo server
. - Visit http://localhost:1313/nou/ with a web browser.
- On cmd windown, Press CTRL+C to stop the service.
update remote repository
- On Git Bash window, type
git add .
and press Enter. - Type
git commit -a -m "new, update"
and press Enter. - Type
git push
and press Enter.
set workflow on remote repository
- Visit settings page https://github.com/dudung/nou/settings.
- Choose Pages https://github.com/dudung/nou/settings/pages.
- Choose Source to GitHub Actions.
- Click browse all workflows https://github.com/dudung/nou/actions/new.
- Type
hugo
on Search workflows field. - Click Configure button on Hugo.
- Click green button, Commit changes…, on top right.
- Click green button, Commit changes, on bottom right.
- Visit repo page https://github.com/dudung/nou.
- Wait the yellow circle • to turn to green check mark ✓.
- Visit https://dudung.github.io/nou/, the GitHub Pages for nou repo.
update local repository
- On Git Bash window, type
git pull
to update local files with the workflow. - Navigate to
.github/workflows/
to seehugo.yml
file for Hugo workflow.
After performing above steps
- Remore repository is https://github.com/dudung/nou.
- GitHub Pages https://dudung.github.io/nou/.
- Local folder
nou
. - Local host http://localhost:1313/nou/.
notes
Cindy Wu, “The Captain’s Log”, Medium, 8 Jun 2017, url https://medium.com/p/fc858f5794f3 [20240501]. ↩︎
Ivy Wigmore, “log (log file)”, TechTarget, 5 Nov 2014, url https://www.techtarget.com/whatis/definition/log-log-file [20240501]. ↩︎
Sally Benning, “USDA Commodity Inventory Log”, Department of Agriculture, 2 May 2002, url https://www.agriculture.pa.gov/Food/food_assistance/The%20Emergency%20Food%20Assistance%20Program/Documents/TEFAP%20Inventory%20Log.pdf [20240501]. ↩︎
-, “Adding Patient Logs”, Exxat, 9 Feb 2024, url https://helpcenter.exxat.com/hc/en-us/articles/15365707728273-Adding-Patient-Logs [20240501]. ↩︎
George Petrides, “Lecture log”, TMA4155 Kryptografi, introduksjon, Institutt for matematiske fag, NTNU, 7 Nov 2012, url https://wiki.math.ntnu.no/tma4155/2012h/log [20240501]. ↩︎
Pete Bahba, “What’s the spirit of the internet? Freedom, equality,customize?”, Quora, 31 Aug 2024, url https://qr.ae/pswoMp [20240501]. ↩︎
Niyat Ghebremichael, “What is the difference between a blog, vlog and slog?”, Zooma, 26 Feb 2019, url https://zooma.agency/en/learn/content-creation/what-is-the-difference-between-a-blog-vlog-and-slog [20240501]. ↩︎
Jayden Harper, “Plogging for Beginners: Tips for Creating Impressive Plog”, VanceAI, 12 Dec 2023, url https://vanceai.com/posts/create-impressive-plog/ [20240501]. ↩︎