Comparaison of Two Docker Images for Hugo
Posted on December 21, 2018
| 1 minutes
| Vincent Tam
|
0 comment
Having importing the repo for the Hugo theme Introduction from GitHub to GitLab, I added the automatically generated GitLab CI config file and I ran job #135854407.
$ cd exampleSite $ hugo --themesDir=../.. -d ../public hugo: /usr/lib/libstdc++.so.6: no version information available (required by hugo) hugo: /usr/lib/libstdc++.so.6: no version information available (required by hugo) The build succeeded with the above message. To suppress it, a switch to another CI runner will do.
[Read More]
Staticman Invitation is Case Sensitive
A recent invitation error under Staticman v3
Posted on December 19, 2018
(Last modified on April 28, 2019)
| 1 minutes
| Vincent Tam
|
1 comment
HTML and URL links are case insensitive. For example, GOOGLE.COM and google.com give the same address. As a result, after creating my fork of Beautiful Jekyll, I invited @staticmanlab to join my GitHub repo by firing the URL
https://staticman3.herokuapp.com/v3/connect/github/vincenttam/beautiful-jekyll but I got
Failed Staticman invitation The case for GitHub user name doens't match
Successful Staticman invitation The case for GitHub user name match
After matching vincenttam with the case of my user name displayed in the link for each of GitHub repos,
[Read More]
Staticman Lab New Logos
Posted on November 21, 2018
(Last modified on April 24, 2019)
| 2 minutes
| Vincent Tam
|
0 comment
StaticmanLab's new logo GitLab logo recreated from Wikimedia's logo by Darby under CC-BY-SA 4.0 and Staticman logo on GitHub by Erlen Masson under MIT.
The old icon for Staticman Lab was made by GIMP from Staticman’s icon in PNG in the GitHub repo. Recently, I’ve found the SVG version of this icon. To serve customers better, I’ve recreated the logo from this SVG file so that the edges in the logo become sharper.
[Read More]
Nested Comments in Beautiful Hugo
Posted on November 17, 2018
(Last modified on December 19, 2018)
| 8 minutes
| Vincent Tam
|
1 comment
Quick links A minimal demo site on GitLab (Source) Beautiful Hugo pull request 222 Pre-release notes for this pull request Motivation For the mathematical ones, please see my previous post.
As a math student, it’s inefficient to reinvent the wheel like engineering students. Thanks to three existing examples, I had convinced myself that I could bring this to the theme Beautiful Hugo.
Zongren’s Hexo theme (worked best)
Made Mistakes Jekyll theme
[Read More]
Interactive Blog on Static Web Host
Posted on November 17, 2018
(Last modified on February 17, 2021)
| 5 minutes
| Vincent Tam
|
1 comment
Vision gain autonomy: freedom is the basis of moral actions. No freedom, no morality. transcend ourselves: change/improve our lives through free thoughts Goal Convert our free thoughts into free code.
Free code allows users around the world to run and/or improve them. This would bring real enhancement to our tools.
For example, beautiful math writing used to be a complicated process. A decade ago, this required the installation of a typesetting engine called $\LaTeX$.
[Read More]
Minimal Jekyll Site with Static Comments
Setup Staticman v3 and Jekyll on GitHub Pages
Posted on September 30, 2018
(Last modified on April 13, 2023)
| 2 minutes
| Vincent Tam
|
1 comment
Introduction This is the GitHub Pages version to my GitLab Pages with Staticman tutorial.
I didn’t plan to test whether Staticman v3 work on GitHub since it’s proprietary. However, from Staticman issues #222 and #227, we know that the official server doesn’t respond to
GET /v2/connnect/<USERNAME>/<REPONAME> To help others, I self-advertised my own Staticman API instance and the migration to GitLab pages. Unfortunately, nobody had managed to create a GitHub repo running on my API instance.
[Read More]
Custom $\KaTeX$ Macros
More efficient math editing
Posted on September 27, 2018
(Last modified on April 13, 2023)
| 2 minutes
| Vincent Tam
|
3 comments
Background Same as the last section in Beautiful Hugo Improvements.
Goal To write math efficiently by automatically loading longer code with shorter macro code.
For example, when I wrote Some Infinite Cardinality Identities, it would be ten times more quicker and efficient to type \card{C} than to write \mathop{\mathrm{card}}(C) all the time.
Changes committed to my repo The current version of Beautiful Hugo is still using $\KaTeX$ v0.7, which doesn’t support macros in auto-rendering.
[Read More]
Better Hugo ToC Fix
A JavaScript free way to improve default ToC
Posted on September 27, 2018
| 1 minutes
| Vincent Tam
|
0 comment
Background
I applied a fix to Hugo’s ToC ten days ago.
Drawbacks
To make the script non-render blocking, one has to place it in the footer.
As a result, it takes about 0.2 seconds to remove the excess <ul> tag.
Solution
Thanks to Beej126’s Hugo template code, this site delivers table of
contents processed by Hugo during GitLab’s continuous deployment.
Staticman API Hosting 2018
Step-by-step guide for free-hosting on Heroku
Posted on September 17, 2018
(Last modified on June 5, 2022)
| 6 minutes
| Vincent Tam
|
16 comments
Update: I suggest reading a newer tutorial for setting up your custom API server that works with GitHub Apps. The package maintainers suggest hosting your own API server.
Goal To host an instance of Staticman v3 server on Heroku.
This post involves server-side setup of the commenting system. If you simply want to have a taste of this system on GitLab, you may try my demo GitLab Page.
I try to address some concerns about this API service in the introduction of this series to keep this page focused on the technical aspects of my customizations against staticman/dev branch.
[Read More]
Fix Hugo Table of Contents
Removal of wrapping HTML tag in JavaScript
Posted on September 17, 2018
(Last modified on September 24, 2018)
| 4 minutes
| Vincent Tam
|
0 comment
Background (TL;DR) While setting up the new version of Staticman for my demo GitLab pages, I’ve read developers’ documentations, setup guide and some community blog posts so as to come up with my own guide. It’s originated and inspired from a variety of sources, and refined according to hours of testing. Consequently, despite the original intention to keep things simple, I’ve finally come up with a post with over a thousand words.
[Read More]