Math student and GNU/Linux user. Support Santilli's keyboard attack to free netizens from censorship.

Build your free personal math blog with comments on GitLab

View demo at https://vincenttam.gitlab.io/bhdemo

Server-side setup

See https://lstu.fr/smguide.

Client-side setup

1. Clone this repo

    git clone --recurse-submodules https://gitlab.com/VincentTam/bhdemo.git <your-site-name>
   

   If this is your personal page, <your-site-name> is <your-user-name>.gitlab.io

2. Start a new project on GitLab named as <your-site-name>

3. Add your GitLab bot user as a "developer" for your project

4. Remove existing comments under the folder data/ and the file LICENSE

5. Modify the following fields in the Hugo config file config.toml. Comment out stuff by #

    baseURL = "https://<username>.gitlab.io"
    title = "Your title"
    [Params]
      subtitle = "Your subtitle"
    [Params.staticman]
      api = "https://<your-api>.herokuapp.com/v3/entry/gitlab/<username>/<username>.gitlab.io/master/comments"
      pulls = "https://gitlab.com/<username>/<username>.gitlab.io/merge_requests"
    [Author]
      name = "Your name"
      website = "https://example.com"
   

If this is your project page, use the following parameters instead

    baseURL = "https://<username>.gitlab.io/<your-project>"
    [Params.staticman]
      api = "https://<your-api>.herokuapp.com/v3/entry/gitlab/<username>/<your-project>/master/comments"
      pulls = "https://gitlab.com/<username>/<your-project>/merge_requests"

4. Either remove the reCAPTCHA config or change the parameters below with your own site key and secret (You may apply your personal ones with your Google account)

    [Params.staticman.recaptcha]
      sitekey = "6Lcv8...--qkFo"
      secret = "p5u...wNw=="
   

5. Remove these lines at the bottom of config.toml

    [[menu.main]]
      name = "Source"
      url = "https://gitlab.com/vincenttam/bhdemo"
      weight = 2
   

6. Edit the bottom of staticman.yml corresponding to (6)

7. Comment moderation:

   • approval before publish: moderation: true.
   • otherwise: go to Settings → Repository → Protected Branches and permit your GitLab bot to push against master branch.

Write new posts.

1. Execute hugo new posts/<your-filename>.md
2. Edit content/posts/<your-filename>.md
3. Save everything with git add .
4. Commit with git commit
5. Publish with git push -u origin master

Demo