Compare commits
212 Commits
commento-c
...
master
Author | SHA1 | Date | |
---|---|---|---|
4ea1fa4650
|
|||
865a71043c
|
|||
be5229b963
|
|||
8625e8ddce
|
|||
a3b5ce6ebd
|
|||
e91a62ee18
|
|||
d450249171
|
|||
86a03a676a
|
|||
beba67ffbd
|
|||
a7b1002e19
|
|||
7851b864e2
|
|||
4d1542a242
|
|||
88b5648a15
|
|||
8a8a35f6e5
|
|||
612d3b6c4f
|
|||
457b1c34cf
|
|||
d23016b564
|
|||
85f77c26de
|
|||
3f3a60c3fc
|
|||
61b31bfa63
|
|||
6a7a253ea5
|
|||
6149d38e61
|
|||
159bd4b61d
|
|||
2a5452858b
|
|||
e80970da7f
|
|||
e8368fd7cb
|
|||
7523df569c
|
|||
20e69d482b
|
|||
e1b6026aea
|
|||
615547c525
|
|||
9e7be7afa3
|
|||
55623221f1
|
|||
36eaa2b145
|
|||
9e0c03b0db
|
|||
744a131b61
|
|||
19cb929ae9
|
|||
b811714ca5
|
|||
508b0f6837
|
|||
eac66611df
|
|||
7a1bf6c19c
|
|||
0f4db51ba7
|
|||
ed9520adef
|
|||
8f6722215e
|
|||
7420561514
|
|||
74dc4e75b2
|
|||
1cf5c2a324
|
|||
9a5a182879
|
|||
5051c908e7
|
|||
186e451422
|
|||
d816b189a2
|
|||
49f57c2b5e
|
|||
8815ec6fe8
|
|||
73a900d36d
|
|||
71e5e214db
|
|||
2e613416e5
|
|||
f0edaa67d5
|
|||
d367d1eda5
|
|||
f9692f238b
|
|||
15f0ec5c3e
|
|||
1e692ddc91
|
|||
d03db67ec0
|
|||
d268898446
|
|||
8f834d2662
|
|||
14565ea343
|
|||
226fcfa099
|
|||
3e03c1a2b0
|
|||
dd9936a74b
|
|||
1574cd8515
|
|||
1d0d621963 | |||
5f44c05e57
|
|||
0e67adf41c
|
|||
b4c695aeb4
|
|||
cdfcf3c372
|
|||
6d7dfa6c5d
|
|||
ef8dda9657
|
|||
f6b27235f3
|
|||
1ce61b8260
|
|||
f719cadd1e
|
|||
43d4f47e29
|
|||
510e3e9bf9
|
|||
685a9ed8f4
|
|||
66fac8058f
|
|||
e93871c923
|
|||
07f586e5b0
|
|||
d21feef5b9
|
|||
e49b0aa583
|
|||
91bc38bdd4
|
|||
b80bd5732d
|
|||
b863f577ae
|
|||
c1806338e5
|
|||
f9c4fd8a9a
|
|||
fb0e45d7cd
|
|||
a0165e8569
|
|||
100a86b85f
|
|||
8321945015
|
|||
48ed6eae21
|
|||
795be223eb
|
|||
0e2a26fe56
|
|||
c228d5c903
|
|||
f2494e515f
|
|||
4cd6632799
|
|||
bde9df2aa6
|
|||
87c5d4f1b3
|
|||
31a72c92fa
|
|||
bc76fb5458
|
|||
ddb0045088
|
|||
2fb0d17df1
|
|||
060d3ecd84
|
|||
fd6eb50399
|
|||
87688ef6b3
|
|||
01c2b34920
|
|||
c014da3fe3
|
|||
7d5309862e
|
|||
cef5fe28dc
|
|||
7a529fb1ac
|
|||
852aafb2e7
|
|||
c50d3fda88
|
|||
6f1c5a883f
|
|||
6a941cef7c
|
|||
44c1291fa4
|
|||
dba36c5105
|
|||
6145d4e8d7
|
|||
c5a2e84050
|
|||
94a2404a83
|
|||
fec8bd1933
|
|||
27bc4e28a8
|
|||
e9ad2abd55
|
|||
f0036f20b9
|
|||
2fc8e4646e
|
|||
da8dc12957
|
|||
86f4b102d7
|
|||
d7e219d331 | |||
5b0c092bc0
|
|||
2ce66a14d4 | |||
8a330b59b0
|
|||
de888c1adc
|
|||
927e775439
|
|||
9c572a706b
|
|||
05c8e0da9d
|
|||
191c9a5185
|
|||
c11c9178e0
|
|||
5719a11e8b
|
|||
bacddbfe42
|
|||
4e6f0c7614
|
|||
20abaffc3a
|
|||
3668b6cfb1
|
|||
f3cf22ae33
|
|||
dde5162907
|
|||
90d640bd12
|
|||
904d8928b7
|
|||
827a049946
|
|||
db65e9fc23
|
|||
bd9d294fc1
|
|||
9de4d26b6a
|
|||
f14c1568f7 | |||
1e650ed79b
|
|||
ba9c62ed4f
|
|||
c3632c40ce | |||
02201e806f
|
|||
d27f095c1a
|
|||
2b38b143b1
|
|||
26ccc90cff
|
|||
d5ef788e78
|
|||
8e2673b4ff
|
|||
c58164f1f2
|
|||
4fb9dbaa30
|
|||
359bfbf1b6
|
|||
d011efd2a1
|
|||
98ef3386f5
|
|||
a170885ff8
|
|||
17af722f4d
|
|||
62c62b344c
|
|||
f50665786b
|
|||
57fac4d945
|
|||
f6602dfff0
|
|||
db6fc9e977
|
|||
86a90f907a
|
|||
3838d2d44a
|
|||
ac05117647
|
|||
355d180f6c
|
|||
0bc3f3145e
|
|||
cbe6a1e12a
|
|||
e1dd193bf1
|
|||
0bb3dce6e9
|
|||
6ad002b319
|
|||
1e20d0e943
|
|||
375b90fb07
|
|||
81fa2f6b41
|
|||
fb7b5913c0
|
|||
d8134587e9
|
|||
4db3d24349
|
|||
4017855c29
|
|||
859537be01
|
|||
164565cecb
|
|||
5d08b75f71
|
|||
5782a6a002
|
|||
e21a4b948e
|
|||
9de124a586
|
|||
4a4361dcb5
|
|||
a449933ffe
|
|||
a57715c4fa
|
|||
3ec98f019c
|
|||
fd4a7a7bc2
|
|||
1f263b3a3a
|
|||
c24cdee46c
|
|||
2a79a86fd6
|
|||
97bc1980eb
|
|||
cef1103070
|
|||
1332c16841
|
|||
b124d89391
|
|||
0d432e200c
|
|||
5286bb029f |
49
.github/workflows/audit.yml
vendored
@ -2,58 +2,29 @@ name: Audit
|
||||
|
||||
on:
|
||||
push:
|
||||
pull_request:
|
||||
|
||||
jobs:
|
||||
audit:
|
||||
runs-on: ubuntu-latest
|
||||
steps:
|
||||
- name: Checkout
|
||||
uses: actions/checkout@v2
|
||||
uses: actions/checkout@v3
|
||||
with:
|
||||
submodules: recursive
|
||||
fetch-depth: 0
|
||||
ref: ${{github.event.pull_request.head.ref}}
|
||||
repository: ${{github.event.pull_request.head.repo.full_name}}
|
||||
|
||||
- name: Read HUGO_VERSION
|
||||
id: hugo_version
|
||||
run: echo "HUGO_VERSION=$(cat HUGO_VERSION)" >> $GITHUB_OUTPUT
|
||||
|
||||
- name: Setup Hugo
|
||||
uses: peaceiris/actions-hugo@v2
|
||||
uses: peaceiris/actions-hugo@v3
|
||||
with:
|
||||
hugo-version: latest
|
||||
hugo-version: ${{ steps.hugo_version.outputs.HUGO_VERSION }}
|
||||
extended: true
|
||||
|
||||
- name: Build
|
||||
run: |
|
||||
HUGO_MINIFY_TDEWOLFF_HTML_KEEPCOMMENTS=true HUGO_ENABLEMISSINGTRANSLATIONPLACEHOLDERS=true hugo --printI18nWarnings --printPathWarnings
|
||||
|
||||
# For the following steps, see
|
||||
# https://discourse.gohugo.io/t/audit-your-published-site-for-problems/35184
|
||||
|
||||
- name: Audit - raw HTML
|
||||
if: always()
|
||||
run: |
|
||||
! grep -inorE "<\!-- raw HTML omitted -->" public/
|
||||
|
||||
- name: Audit - ZgotmplZ (unsafe URL content)
|
||||
if: always()
|
||||
run: |
|
||||
! grep -inorE "ZgotmplZ" public/
|
||||
|
||||
#- name: Audit - missing translations
|
||||
# if: always()
|
||||
# run: |
|
||||
# ! grep -inorE "\[i18n\]" public/
|
||||
|
||||
- name: Audit - nil values in printf
|
||||
if: always()
|
||||
run: |
|
||||
! grep -inorE "\(<nil>\)" public/
|
||||
|
||||
- name: Audit - nil values in printf without safeHTML
|
||||
if: always()
|
||||
run: |
|
||||
! grep -inorE "(<nil>)" public/
|
||||
|
||||
- name: Audit - HAHAHUGO
|
||||
if: always()
|
||||
run: |
|
||||
! grep -inorE "hahahugo" public/
|
||||
- name: Run audit
|
||||
run: ./audit.sh
|
||||
|
26
.github/workflows/deploy.yml
vendored
@ -1,5 +1,9 @@
|
||||
name: Deploy
|
||||
|
||||
concurrency:
|
||||
group: deploy-production
|
||||
cancel-in-progress: true
|
||||
|
||||
on:
|
||||
workflow_dispatch:
|
||||
push:
|
||||
@ -14,23 +18,29 @@ jobs:
|
||||
url: https://bbaovanc.com
|
||||
steps:
|
||||
- name: Checkout
|
||||
uses: actions/checkout@v2
|
||||
uses: actions/checkout@v3
|
||||
with:
|
||||
submodules: recursive
|
||||
fetch-depth: 0
|
||||
|
||||
- name: Read HUGO_VERSION
|
||||
id: hugo_version
|
||||
run: echo "HUGO_VERSION=$(cat HUGO_VERSION)" >> $GITHUB_OUTPUT
|
||||
|
||||
- name: Setup Hugo
|
||||
uses: peaceiris/actions-hugo@v2
|
||||
uses: peaceiris/actions-hugo@v3
|
||||
with:
|
||||
hugo-version: latest
|
||||
hugo-version: ${{ steps.hugo_version.outputs.HUGO_VERSION }}
|
||||
extended: true
|
||||
|
||||
- name: Build
|
||||
run: hugo --printI18nWarnings --printPathWarnings
|
||||
|
||||
- name: Compress
|
||||
- name: Download Pagefind
|
||||
run: |
|
||||
time sudo ./compress.sh
|
||||
mkdir -p ~/.local/bin/
|
||||
echo "$HOME/.local/bin" >> "$GITHUB_PATH"
|
||||
curl -L https://github.com/Pagefind/pagefind/releases/download/v1.3.0/pagefind-v1.3.0-x86_64-unknown-linux-musl.tar.gz | tar zxv -C ~/.local/bin pagefind
|
||||
|
||||
- name: Build
|
||||
run: ./build.sh
|
||||
|
||||
- name: Setup SSH
|
||||
uses: kielabokkie/ssh-key-and-known-hosts-action@v1
|
||||
|
72
.github/workflows/diff.yml
vendored
Normal file
@ -0,0 +1,72 @@
|
||||
name: Diff
|
||||
|
||||
on:
|
||||
push:
|
||||
pull_request:
|
||||
|
||||
jobs:
|
||||
compare:
|
||||
runs-on: ubuntu-latest
|
||||
steps:
|
||||
- name: Checkout previous (pull_request)
|
||||
if: github.event.pull_request
|
||||
uses: actions/checkout@v3
|
||||
with:
|
||||
submodules: recursive
|
||||
fetch-depth: 0
|
||||
ref: ${{ github.event.pull_request.base.ref }}
|
||||
|
||||
- name: Checkout previous (push)
|
||||
if: github.event_name == 'push'
|
||||
uses: actions/checkout@v3
|
||||
with:
|
||||
submodules: recursive
|
||||
fetch-depth: 0
|
||||
ref: ${{ github.event.before }}
|
||||
|
||||
- name: Read HUGO_VERSION (previous)
|
||||
id: hugo_version_old
|
||||
run: echo "HUGO_VERSION=$(cat HUGO_VERSION)" >> $GITHUB_OUTPUT
|
||||
|
||||
- name: Setup Hugo (previous)
|
||||
uses: peaceiris/actions-hugo@v3
|
||||
with:
|
||||
hugo-version: ${{ steps.hugo_version_old.outputs.HUGO_VERSION }}
|
||||
extended: true
|
||||
|
||||
- name: Build previous
|
||||
run: |
|
||||
NO_SEARCH=y NO_COMPRESS=y DEST=old/ ./build.sh
|
||||
|
||||
- name: Checkout current
|
||||
uses: actions/checkout@v3
|
||||
with:
|
||||
submodules: recursive
|
||||
fetch-depth: 0
|
||||
clean: false
|
||||
|
||||
- name: Read HUGO_VERSION (current)
|
||||
id: hugo_version_new
|
||||
run: echo "HUGO_VERSION=$(cat HUGO_VERSION)" >> $GITHUB_OUTPUT
|
||||
|
||||
- name: Setup Hugo (current)
|
||||
uses: peaceiris/actions-hugo@v3
|
||||
with:
|
||||
hugo-version: ${{ steps.hugo_version_new.outputs.HUGO_VERSION }}
|
||||
extended: true
|
||||
|
||||
- name: Build current
|
||||
run: |
|
||||
NO_SEARCH=y NO_COMPRESS=y DEST=new/ ./build.sh
|
||||
|
||||
- name: Print filenames changed
|
||||
run: diff -qr old/ new/ || true
|
||||
|
||||
- name: Save full diff
|
||||
run: diff -r old/ new/ | tee changes.diff || true
|
||||
|
||||
- name: Upload full diff
|
||||
uses: actions/upload-artifact@v4
|
||||
with:
|
||||
name: diff
|
||||
path: changes.diff
|
17
.github/workflows/pull_request.yml
vendored
@ -12,7 +12,7 @@ jobs:
|
||||
runs-on: ubuntu-latest
|
||||
steps:
|
||||
- name: Checkout
|
||||
uses: actions/checkout@v2
|
||||
uses: actions/checkout@v3
|
||||
with:
|
||||
submodules: recursive
|
||||
fetch-depth: 0
|
||||
@ -29,18 +29,18 @@ jobs:
|
||||
ref: ${{ github.head_ref }}
|
||||
no_override: false
|
||||
|
||||
- name: Read HUGO_VERSION
|
||||
id: hugo_version
|
||||
run: echo "HUGO_VERSION=$(cat HUGO_VERSION)" >> $GITHUB_OUTPUT
|
||||
|
||||
- name: Setup Hugo
|
||||
uses: peaceiris/actions-hugo@v2
|
||||
uses: peaceiris/actions-hugo@v3
|
||||
with:
|
||||
hugo-version: latest
|
||||
hugo-version: ${{ steps.hugo_version.outputs.HUGO_VERSION }}
|
||||
extended: true
|
||||
|
||||
- name: Build
|
||||
run: hugo --printI18nWarnings --printPathWarnings --baseURL "https://demo.bbaovanc.com/pull_request/${{ github.event.number }}"
|
||||
|
||||
- name: Compress
|
||||
run: |
|
||||
time sudo ./compress.sh
|
||||
run: ./build.sh --baseURL "https://demo.bbaovanc.com/pull_request/${{ github.event.number }}"
|
||||
|
||||
- name: Setup SSH
|
||||
uses: kielabokkie/ssh-key-and-known-hosts-action@v1
|
||||
@ -91,5 +91,4 @@ jobs:
|
||||
A preview of this pull request is ready!
|
||||
See it at https://demo.bbaovanc.com/pull_request/${{ github.event.number }}/
|
||||
View the deploy log at https://github.com/BBaoVanC/bbaovanc.com/actions/runs/${{ github.run_id}}
|
||||
Please note that currently the comment system is only operational on real deploys on bbaovanc.com. If you see an error, it's probably not your fault.
|
||||
edit-mode: replace
|
||||
|
2
.github/workflows/pull_request_cleanup.yml
vendored
@ -1,7 +1,7 @@
|
||||
name: Pull Request Cleanup
|
||||
|
||||
on:
|
||||
pull_request:
|
||||
pull_request_target:
|
||||
types:
|
||||
- closed
|
||||
|
||||
|
5
.gitignore
vendored
@ -17,5 +17,6 @@ hugo.linux
|
||||
|
||||
/.hugo_build.lock
|
||||
|
||||
# My private drafts
|
||||
/content/blog/drafts/
|
||||
# used in demo.sh and staging.sh
|
||||
/public.demo/
|
||||
/public.staging/
|
||||
|
@ -1,69 +1,22 @@
|
||||
# Contributing to bobatheme
|
||||
|
||||
## Where to put stuff
|
||||
|
||||
### Discussions
|
||||
|
||||
The best place to ask questions or have discussions is the (relatively new)
|
||||
discussions feature on GitHub, available
|
||||
[here](https://github.com/BBaoVanC/bbaovanc.com/discussions). It's not too big
|
||||
of an issue though because discussions and issues can easily be converted
|
||||
between eachother.
|
||||
|
||||
### Issues
|
||||
|
||||
Issues should be used only for, well, issues. Ignore all the placeholder ones
|
||||
prefixed with "Translate:" and tagged with the "translation" tag as they are
|
||||
placeholders used in the projects tab. I might mark them as closed in the future
|
||||
to clean it up but I'll worry about that later.
|
||||
|
||||
### Translations
|
||||
|
||||
Discussion relating to translations should either go as comments or reviews on
|
||||
the pull request adding the translation, or as a discussion under the
|
||||
[Translations category](https://github.com/BBaoVanC/bbaovanc.com/discussions/categories/translations).
|
||||
|
||||
## Writing translations
|
||||
|
||||
Translations should aim to get the meaning as close as possible to original
|
||||
document. The changes in a translation pull request *should*:
|
||||
|
||||
- only update one page (multiple pages should be split into separate pull
|
||||
requests)
|
||||
- only contain changes for a single new file (no changes unrelated to
|
||||
translation)
|
||||
- thoroughly compared to the original text in order to get the same meaning
|
||||
across
|
||||
|
||||
## Pull requests
|
||||
|
||||
### Commit messages
|
||||
|
||||
It's not too big of a deal what you put in your commit messages, but try to give
|
||||
each commit a rough description of what it changes. I'll use squash merges most
|
||||
of the time anyways.
|
||||
|
||||
### Description
|
||||
|
||||
If the pull request doesn't require any extra information in addition to the
|
||||
title, you can probably leave the description blank. Otherwise you can put some
|
||||
information, just try to keep it concise; it's better to read a couple sentences
|
||||
than an entire essay with the same amount of information.
|
||||
|
||||
## Building
|
||||
|
||||
## Automatic deploy previews with Netlify
|
||||
Just in case you need it.
|
||||
|
||||
Netlify will automatically build each pull request into a public deploy preview,
|
||||
and will link it in a comment.
|
||||
### Automatic deploy previews with GitHub Actions
|
||||
|
||||
## Manual (local) building
|
||||
My GitHub Actions workflows will automatically build each pull request into a
|
||||
public deploy preview on demo.bbaovanc.com, and will link it in a comment.
|
||||
|
||||
### Manual (local) building
|
||||
|
||||
You can also build the site yourself using Hugo, including a live local preview.
|
||||
|
||||
1. Make sure you install the latest version of Hugo, or at least the
|
||||
1. Make sure you install the latest version of Hugo, or hopefully at least the
|
||||
`min_version` listed in
|
||||
[theme.toml](https://github.com/BBaoVanC/bobatheme/blob/master/theme.toml#L11).
|
||||
Let me know if that minimum version isn't enough and I'll fix it.
|
||||
2. Clone the repo
|
||||
3. Make sure to download and checkout the submodules (use `git submodule update
|
||||
--init --recursive`). The `--recursive` flag is especially important because
|
||||
|
1
HUGO_VERSION
Normal file
@ -0,0 +1 @@
|
||||
0.147.9
|
207
LICENSE
@ -1,25 +1,49 @@
|
||||
Attribution 4.0 International
|
||||
The non-content code in this repository follows the MIT License:
|
||||
|
||||
=======================================================================
|
||||
Copyright (c) 2021 BBaoVanC
|
||||
|
||||
Creative Commons Corporation ("Creative Commons") is not a law firm and
|
||||
does not provide legal services or legal advice. Distribution of
|
||||
Creative Commons public licenses does not create a lawyer-client or
|
||||
other relationship. Creative Commons makes its licenses and related
|
||||
information available on an "as-is" basis. Creative Commons gives no
|
||||
warranties regarding its licenses, any material licensed under their
|
||||
terms and conditions, or any related information. Creative Commons
|
||||
disclaims all liability for damages resulting from their use to the
|
||||
fullest extent possible.
|
||||
Permission is hereby granted, free of charge, to any person obtaining a copy
|
||||
of this software and associated documentation files (the "Software"), to deal
|
||||
in the Software without restriction, including without limitation the rights
|
||||
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
||||
copies of the Software, and to permit persons to whom the Software is
|
||||
furnished to do so, subject to the following conditions:
|
||||
|
||||
Using Creative Commons Public Licenses
|
||||
The above copyright notice and this permission notice shall be included in all
|
||||
copies or substantial portions of the Software.
|
||||
|
||||
Creative Commons public licenses provide a standard set of terms and
|
||||
conditions that creators and other rights holders may use to share
|
||||
original works of authorship and other material subject to copyright
|
||||
and certain other rights specified in the public license below. The
|
||||
following considerations are for informational purposes only, are not
|
||||
exhaustive, and do not form part of our licenses.
|
||||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
||||
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
||||
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
||||
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
||||
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
||||
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
||||
SOFTWARE.
|
||||
|
||||
The content (articles, images/media, etc) follow CC-BY-SA 4.0:
|
||||
|
||||
Attribution-ShareAlike 4.0 International
|
||||
|
||||
=======================================================================
|
||||
|
||||
Creative Commons Corporation ("Creative Commons") is not a law firm and
|
||||
does not provide legal services or legal advice. Distribution of
|
||||
Creative Commons public licenses does not create a lawyer-client or
|
||||
other relationship. Creative Commons makes its licenses and related
|
||||
information available on an "as-is" basis. Creative Commons gives no
|
||||
warranties regarding its licenses, any material licensed under their
|
||||
terms and conditions, or any related information. Creative Commons
|
||||
disclaims all liability for damages resulting from their use to the
|
||||
fullest extent possible.
|
||||
|
||||
Using Creative Commons Public Licenses
|
||||
|
||||
Creative Commons public licenses provide a standard set of terms and
|
||||
conditions that creators and other rights holders may use to share
|
||||
original works of authorship and other material subject to copyright
|
||||
and certain other rights specified in the public license below. The
|
||||
following considerations are for informational purposes only, are not
|
||||
exhaustive, and do not form part of our licenses.
|
||||
|
||||
Considerations for licensors: Our public licenses are
|
||||
intended for use by those authorized to give the public
|
||||
@ -52,21 +76,23 @@ exhaustive, and do not form part of our licenses.
|
||||
for the public:
|
||||
wiki.creativecommons.org/Considerations_for_licensees
|
||||
|
||||
=======================================================================
|
||||
=======================================================================
|
||||
|
||||
Creative Commons Attribution 4.0 International Public License
|
||||
Creative Commons Attribution-ShareAlike 4.0 International Public
|
||||
License
|
||||
|
||||
By exercising the Licensed Rights (defined below), You accept and agree
|
||||
to be bound by the terms and conditions of this Creative Commons
|
||||
Attribution 4.0 International Public License ("Public License"). To the
|
||||
extent this Public License may be interpreted as a contract, You are
|
||||
granted the Licensed Rights in consideration of Your acceptance of
|
||||
these terms and conditions, and the Licensor grants You such rights in
|
||||
consideration of benefits the Licensor receives from making the
|
||||
Licensed Material available under these terms and conditions.
|
||||
By exercising the Licensed Rights (defined below), You accept and agree
|
||||
to be bound by the terms and conditions of this Creative Commons
|
||||
Attribution-ShareAlike 4.0 International Public License ("Public
|
||||
License"). To the extent this Public License may be interpreted as a
|
||||
contract, You are granted the Licensed Rights in consideration of Your
|
||||
acceptance of these terms and conditions, and the Licensor grants You
|
||||
such rights in consideration of benefits the Licensor receives from
|
||||
making the Licensed Material available under these terms and
|
||||
conditions.
|
||||
|
||||
|
||||
Section 1 -- Definitions.
|
||||
Section 1 -- Definitions.
|
||||
|
||||
a. Adapted Material means material subject to Copyright and Similar
|
||||
Rights that is derived from or based upon the Licensed Material
|
||||
@ -82,7 +108,11 @@ Section 1 -- Definitions.
|
||||
and Similar Rights in Your contributions to Adapted Material in
|
||||
accordance with the terms and conditions of this Public License.
|
||||
|
||||
c. Copyright and Similar Rights means copyright and/or similar rights
|
||||
c. BY-SA Compatible License means a license listed at
|
||||
creativecommons.org/compatiblelicenses, approved by Creative
|
||||
Commons as essentially the equivalent of this Public License.
|
||||
|
||||
d. Copyright and Similar Rights means copyright and/or similar rights
|
||||
closely related to copyright including, without limitation,
|
||||
performance, broadcast, sound recording, and Sui Generis Database
|
||||
Rights, without regard to how the rights are labeled or
|
||||
@ -90,29 +120,33 @@ Section 1 -- Definitions.
|
||||
specified in Section 2(b)(1)-(2) are not Copyright and Similar
|
||||
Rights.
|
||||
|
||||
d. Effective Technological Measures means those measures that, in the
|
||||
e. Effective Technological Measures means those measures that, in the
|
||||
absence of proper authority, may not be circumvented under laws
|
||||
fulfilling obligations under Article 11 of the WIPO Copyright
|
||||
Treaty adopted on December 20, 1996, and/or similar international
|
||||
agreements.
|
||||
|
||||
e. Exceptions and Limitations means fair use, fair dealing, and/or
|
||||
f. Exceptions and Limitations means fair use, fair dealing, and/or
|
||||
any other exception or limitation to Copyright and Similar Rights
|
||||
that applies to Your use of the Licensed Material.
|
||||
|
||||
f. Licensed Material means the artistic or literary work, database,
|
||||
g. License Elements means the license attributes listed in the name
|
||||
of a Creative Commons Public License. The License Elements of this
|
||||
Public License are Attribution and ShareAlike.
|
||||
|
||||
h. Licensed Material means the artistic or literary work, database,
|
||||
or other material to which the Licensor applied this Public
|
||||
License.
|
||||
|
||||
g. Licensed Rights means the rights granted to You subject to the
|
||||
i. Licensed Rights means the rights granted to You subject to the
|
||||
terms and conditions of this Public License, which are limited to
|
||||
all Copyright and Similar Rights that apply to Your use of the
|
||||
Licensed Material and that the Licensor has authority to license.
|
||||
|
||||
h. Licensor means the individual(s) or entity(ies) granting rights
|
||||
j. Licensor means the individual(s) or entity(ies) granting rights
|
||||
under this Public License.
|
||||
|
||||
i. Share means to provide material to the public by any means or
|
||||
k. Share means to provide material to the public by any means or
|
||||
process that requires permission under the Licensed Rights, such
|
||||
as reproduction, public display, public performance, distribution,
|
||||
dissemination, communication, or importation, and to make material
|
||||
@ -120,17 +154,17 @@ Section 1 -- Definitions.
|
||||
public may access the material from a place and at a time
|
||||
individually chosen by them.
|
||||
|
||||
j. Sui Generis Database Rights means rights other than copyright
|
||||
l. Sui Generis Database Rights means rights other than copyright
|
||||
resulting from Directive 96/9/EC of the European Parliament and of
|
||||
the Council of 11 March 1996 on the legal protection of databases,
|
||||
as amended and/or succeeded, as well as other essentially
|
||||
equivalent rights anywhere in the world.
|
||||
|
||||
k. You means the individual or entity exercising the Licensed Rights
|
||||
m. You means the individual or entity exercising the Licensed Rights
|
||||
under this Public License. Your has a corresponding meaning.
|
||||
|
||||
|
||||
Section 2 -- Scope.
|
||||
Section 2 -- Scope.
|
||||
|
||||
a. License grant.
|
||||
|
||||
@ -172,7 +206,13 @@ Section 2 -- Scope.
|
||||
Licensed Rights under the terms and conditions of this
|
||||
Public License.
|
||||
|
||||
b. No downstream restrictions. You may not offer or impose
|
||||
b. Additional offer from the Licensor -- Adapted Material.
|
||||
Every recipient of Adapted Material from You
|
||||
automatically receives an offer from the Licensor to
|
||||
exercise the Licensed Rights in the Adapted Material
|
||||
under the conditions of the Adapter's License You apply.
|
||||
|
||||
c. No downstream restrictions. You may not offer or impose
|
||||
any additional or different terms or conditions on, or
|
||||
apply any Effective Technological Measures to, the
|
||||
Licensed Material if doing so restricts exercise of the
|
||||
@ -207,10 +247,10 @@ Section 2 -- Scope.
|
||||
reserves any right to collect such royalties.
|
||||
|
||||
|
||||
Section 3 -- License Conditions.
|
||||
Section 3 -- License Conditions.
|
||||
|
||||
Your exercise of the Licensed Rights is expressly made subject to the
|
||||
following conditions.
|
||||
Your exercise of the Licensed Rights is expressly made subject to the
|
||||
following conditions.
|
||||
|
||||
a. Attribution.
|
||||
|
||||
@ -254,15 +294,30 @@ following conditions.
|
||||
information required by Section 3(a)(1)(A) to the extent
|
||||
reasonably practicable.
|
||||
|
||||
4. If You Share Adapted Material You produce, the Adapter's
|
||||
License You apply must not prevent recipients of the Adapted
|
||||
Material from complying with this Public License.
|
||||
b. ShareAlike.
|
||||
|
||||
In addition to the conditions in Section 3(a), if You Share
|
||||
Adapted Material You produce, the following conditions also apply.
|
||||
|
||||
1. The Adapter's License You apply must be a Creative Commons
|
||||
license with the same License Elements, this version or
|
||||
later, or a BY-SA Compatible License.
|
||||
|
||||
2. You must include the text of, or the URI or hyperlink to, the
|
||||
Adapter's License You apply. You may satisfy this condition
|
||||
in any reasonable manner based on the medium, means, and
|
||||
context in which You Share Adapted Material.
|
||||
|
||||
3. You may not offer or impose any additional or different terms
|
||||
or conditions on, or apply any Effective Technological
|
||||
Measures to, Adapted Material that restrict exercise of the
|
||||
rights granted under the Adapter's License You apply.
|
||||
|
||||
|
||||
Section 4 -- Sui Generis Database Rights.
|
||||
Section 4 -- Sui Generis Database Rights.
|
||||
|
||||
Where the Licensed Rights include Sui Generis Database Rights that
|
||||
apply to Your use of the Licensed Material:
|
||||
Where the Licensed Rights include Sui Generis Database Rights that
|
||||
apply to Your use of the Licensed Material:
|
||||
|
||||
a. for the avoidance of doubt, Section 2(a)(1) grants You the right
|
||||
to extract, reuse, reproduce, and Share all or a substantial
|
||||
@ -271,17 +326,18 @@ apply to Your use of the Licensed Material:
|
||||
b. if You include all or a substantial portion of the database
|
||||
contents in a database in which You have Sui Generis Database
|
||||
Rights, then the database in which You have Sui Generis Database
|
||||
Rights (but not its individual contents) is Adapted Material; and
|
||||
Rights (but not its individual contents) is Adapted Material,
|
||||
including for purposes of Section 3(b); and
|
||||
|
||||
c. You must comply with the conditions in Section 3(a) if You Share
|
||||
all or a substantial portion of the contents of the database.
|
||||
|
||||
For the avoidance of doubt, this Section 4 supplements and does not
|
||||
replace Your obligations under this Public License where the Licensed
|
||||
Rights include other Copyright and Similar Rights.
|
||||
For the avoidance of doubt, this Section 4 supplements and does not
|
||||
replace Your obligations under this Public License where the Licensed
|
||||
Rights include other Copyright and Similar Rights.
|
||||
|
||||
|
||||
Section 5 -- Disclaimer of Warranties and Limitation of Liability.
|
||||
Section 5 -- Disclaimer of Warranties and Limitation of Liability.
|
||||
|
||||
a. UNLESS OTHERWISE SEPARATELY UNDERTAKEN BY THE LICENSOR, TO THE
|
||||
EXTENT POSSIBLE, THE LICENSOR OFFERS THE LICENSED MATERIAL AS-IS
|
||||
@ -310,7 +366,7 @@ Section 5 -- Disclaimer of Warranties and Limitation of Liability.
|
||||
waiver of all liability.
|
||||
|
||||
|
||||
Section 6 -- Term and Termination.
|
||||
Section 6 -- Term and Termination.
|
||||
|
||||
a. This Public License applies for the term of the Copyright and
|
||||
Similar Rights licensed here. However, if You fail to comply with
|
||||
@ -339,7 +395,7 @@ Section 6 -- Term and Termination.
|
||||
License.
|
||||
|
||||
|
||||
Section 7 -- Other Terms and Conditions.
|
||||
Section 7 -- Other Terms and Conditions.
|
||||
|
||||
a. The Licensor shall not be bound by any additional or different
|
||||
terms or conditions communicated by You unless expressly agreed.
|
||||
@ -349,7 +405,7 @@ Section 7 -- Other Terms and Conditions.
|
||||
independent of the terms and conditions of this Public License.
|
||||
|
||||
|
||||
Section 8 -- Interpretation.
|
||||
Section 8 -- Interpretation.
|
||||
|
||||
a. For the avoidance of doubt, this Public License does not, and
|
||||
shall not be interpreted to, reduce, limit, restrict, or impose
|
||||
@ -373,24 +429,23 @@ Section 8 -- Interpretation.
|
||||
processes of any jurisdiction or authority.
|
||||
|
||||
|
||||
=======================================================================
|
||||
=======================================================================
|
||||
|
||||
Creative Commons is not a party to its public
|
||||
licenses. Notwithstanding, Creative Commons may elect to apply one of
|
||||
its public licenses to material it publishes and in those instances
|
||||
will be considered the “Licensor.” The text of the Creative Commons
|
||||
public licenses is dedicated to the public domain under the CC0 Public
|
||||
Domain Dedication. Except for the limited purpose of indicating that
|
||||
material is shared under a Creative Commons public license or as
|
||||
otherwise permitted by the Creative Commons policies published at
|
||||
creativecommons.org/policies, Creative Commons does not authorize the
|
||||
use of the trademark "Creative Commons" or any other trademark or logo
|
||||
of Creative Commons without its prior written consent including,
|
||||
without limitation, in connection with any unauthorized modifications
|
||||
to any of its public licenses or any other arrangements,
|
||||
understandings, or agreements concerning use of licensed material. For
|
||||
the avoidance of doubt, this paragraph does not form part of the
|
||||
public licenses.
|
||||
|
||||
Creative Commons may be contacted at creativecommons.org.
|
||||
Creative Commons is not a party to its public
|
||||
licenses. Notwithstanding, Creative Commons may elect to apply one of
|
||||
its public licenses to material it publishes and in those instances
|
||||
will be considered the "Licensor." The text of the Creative Commons
|
||||
public licenses is dedicated to the public domain under the CC0 Public
|
||||
Domain Dedication. Except for the limited purpose of indicating that
|
||||
material is shared under a Creative Commons public license or as
|
||||
otherwise permitted by the Creative Commons policies published at
|
||||
creativecommons.org/policies, Creative Commons does not authorize the
|
||||
use of the trademark "Creative Commons" or any other trademark or logo
|
||||
of Creative Commons without its prior written consent including,
|
||||
without limitation, in connection with any unauthorized modifications
|
||||
to any of its public licenses or any other arrangements,
|
||||
understandings, or agreements concerning use of licensed material. For
|
||||
the avoidance of doubt, this paragraph does not form part of the
|
||||
public licenses.
|
||||
|
||||
Creative Commons may be contacted at creativecommons.org.
|
||||
|
@ -1,3 +1,5 @@
|
||||
# bbaovanc.com
|
||||
|
||||
My personal website, generated using [Hugo](https://gohugo.io)
|
||||
|
||||
It is live at https://bbaovanc.com.
|
||||
|
121
assets/css/comments.css
Normal file
@ -0,0 +1,121 @@
|
||||
/* Isso styling */
|
||||
h4.isso-thread-heading {
|
||||
color: var(--text-0);
|
||||
margin-bottom: 8px;
|
||||
}
|
||||
|
||||
.isso-comment:not(:first-of-type),
|
||||
.isso-follow-up .isso-comment {
|
||||
border-color: var(--background-3);
|
||||
}
|
||||
|
||||
.isso-author,
|
||||
.isso-page-author-suffix,
|
||||
.isso-comment-footer,
|
||||
.isso-comment-footer .isso-votes {
|
||||
color: var(--text-gray-0);
|
||||
}
|
||||
|
||||
.isso-comment-header .isso-spacer,
|
||||
.isso-spacer:hover,
|
||||
.isso-permalink,
|
||||
.isso-permalink:hover {
|
||||
color: var(--text-gray-1) !important;
|
||||
}
|
||||
a.isso-author:hover,
|
||||
.isso-permalink:hover {
|
||||
text-decoration: underline !important;
|
||||
}
|
||||
|
||||
.isso-comment.isso-is-page-author > .isso-text-wrapper {
|
||||
background-color: var(--background-accent-1);
|
||||
}
|
||||
|
||||
.isso-feedlink:hover,
|
||||
.isso-reply {
|
||||
color: var(--link-0) !important;
|
||||
text-shadow: unset !important;
|
||||
}
|
||||
.isso-reply:hover {
|
||||
text-decoration: underline;
|
||||
}
|
||||
|
||||
.isso-text pre,
|
||||
.isso-text :not(pre) > code {
|
||||
background-color: var(--background-2);
|
||||
border: none;
|
||||
padding: 2px 4px;
|
||||
border-radius: 5px;
|
||||
/* thanks isso.css for setting this to 85% for whatever reason */
|
||||
font-size: 0.75em;
|
||||
}
|
||||
|
||||
.isso-input-wrapper input,
|
||||
.isso-post-action > input,
|
||||
.isso-textarea,
|
||||
.isso-preview {
|
||||
color: var(--text-1);
|
||||
background-color: var(--background-1);
|
||||
border-color: var(--background-2) !important;
|
||||
}
|
||||
|
||||
.isso-input-wrapper input:focus,
|
||||
.isso-textarea:focus {
|
||||
border-color: var(--background-3) !important;
|
||||
}
|
||||
|
||||
.isso-post-action > input:hover {
|
||||
background-color: var(--background-2);
|
||||
}
|
||||
.isso-post-action > input:focus,
|
||||
.isso-post-action > input:active {
|
||||
background-color: var(--background-3);
|
||||
}
|
||||
|
||||
.isso-textarea {
|
||||
margin-bottom: 4px;
|
||||
}
|
||||
.isso-input-wrapper {
|
||||
display: inline-flex;
|
||||
flex-direction: column;
|
||||
margin-right: 4px;
|
||||
max-width: 25%;
|
||||
}
|
||||
.isso-input-wrapper input {
|
||||
order: 1;
|
||||
}
|
||||
.isso-input-wrapper label {
|
||||
order: 2;
|
||||
font-size: small;
|
||||
}
|
||||
.isso-post-action {
|
||||
margin-left: 4px;
|
||||
margin-top: 0;
|
||||
}
|
||||
@media screen and (max-width: 600px) {
|
||||
.isso-input-wrapper {
|
||||
display: block;
|
||||
max-width: 100%;
|
||||
}
|
||||
}
|
||||
|
||||
@media print {
|
||||
.comments {
|
||||
break-before: always;
|
||||
}
|
||||
.isso-comment {
|
||||
max-width: unset;
|
||||
}
|
||||
.isso-text-wrapper {
|
||||
break-inside: avoid;
|
||||
}
|
||||
|
||||
.isso-postbox,
|
||||
.isso-feedlink {
|
||||
display: none;
|
||||
}
|
||||
}
|
||||
|
||||
.isso-target {
|
||||
animation: target-fade 10s ease-out; /* defined in bobatheme */
|
||||
}
|
9
assets/css/search.css
Normal file
@ -0,0 +1,9 @@
|
||||
/* put on body so it overrides the defaults set in :root by pagefind.css */
|
||||
body {
|
||||
/* https://pagefind.app/docs/ui-usage/#customising-the-styles */
|
||||
--pagefind-ui-background: var(--background-1);
|
||||
--pagefind-ui-border: var(--background-2);
|
||||
--pagefind-ui-primary: var(--link-0);
|
||||
--pagefind-ui-tag: var(--background-1);
|
||||
--pagefind-ui-text: var(--text-1);
|
||||
}
|
3
assets/js/share-event.js
Normal file
@ -0,0 +1,3 @@
|
||||
function share_event(service) {
|
||||
plausible("Share", {props: {Network: service}});
|
||||
}
|
12
audit.sh
Executable file
@ -0,0 +1,12 @@
|
||||
#!/bin/sh -x
|
||||
|
||||
# AUDIT flag already skips compression and search generation
|
||||
HUGO_MINIFY_TDEWOLFF_HTML_KEEPCOMMENTS=true HUGO_ENABLEMISSINGTRANSLATIONPLACEHOLDERS=true hugo --buildDrafts --printI18nWarnings --printPathWarnings -d public.audit/
|
||||
|
||||
# https://gohugo.io/troubleshooting/audit/
|
||||
! grep -inorE "<\!-- raw HTML omitted -->|ZgotmplZ|\[i18n\]|\(<nil>\)|(<nil>)|hahahugo" public.audit/
|
||||
|
||||
# see layouts/baseof.html in bobatheme
|
||||
! grep -inorE "YUZSIQGHE" public.audit/
|
||||
|
||||
rm -r public.audit/
|
16
build.sh
Executable file
@ -0,0 +1,16 @@
|
||||
#!/bin/bash -ex
|
||||
# POSIX sh doesn't have the time command
|
||||
|
||||
[ -z "$DEST" ] && DEST="public/"
|
||||
rm -rf "$DEST"
|
||||
|
||||
hugo --printI18nWarnings --printPathWarnings -d "$DEST" $@
|
||||
|
||||
if [ -z "$NO_SEARCH" ]; then
|
||||
time pagefind --site "$DEST"
|
||||
fi
|
||||
|
||||
if [ -z "$NO_COMPRESS" ]; then
|
||||
export DEST
|
||||
./compress.sh
|
||||
fi
|
14
compress.sh
@ -1,6 +1,12 @@
|
||||
#!/bin/sh
|
||||
#!/bin/bash
|
||||
# POSIX sh does not have time command so we must use bash
|
||||
|
||||
files=$(find public/ -name "*.html" -o -name "*.xml" -o -name "*.css" -o -name "*.js" -o -name "*.svg")
|
||||
[ -z "$DEST" ] && echo "Please provide DEST variable for compress.sh" && exit 1
|
||||
|
||||
printf '%s\n' "$files" | parallel $@ "echo 'GZIP {}' && gzip -fnk {}"
|
||||
printf '%s\n' "$files" | parallel $@ "echo 'BROTLI {}' && brotli -fZk {}"
|
||||
files=$(find "$DEST" -name "*.html" -o -name "*.xml" -o -name "*.css" -o -name "*.js" -o -name "*.svg")
|
||||
|
||||
time printf '%s\n' "$files" | parallel $@ "echo 'GZIP {}' && gzip -fnk {}"
|
||||
time printf '%s\n' "$files" | parallel $@ "echo 'BROTLI {}' && brotli -fZk {}"
|
||||
# level 9 chosen based on `zstd -b1 -e22 public/blog/swapfile-guide/index.html`
|
||||
# gives a slightly better ratio than default (3)
|
||||
time printf '%s\n' "$files" | parallel $@ "echo 'ZSTD {}' && zstd -q -f -9 {}"
|
||||
|
50
config.yaml
@ -1,50 +0,0 @@
|
||||
baseURL: https://bbaovanc.com
|
||||
theme: bobatheme
|
||||
defaultContentLanguage: en
|
||||
copyright: '© 2021 bbaovanc <a rel="license" href="https://creativecommons.org/licenses/by/4.0/">CC BY 4.0</a>'
|
||||
sectionPagesMenu: main
|
||||
enableRobotsTXT: true
|
||||
paginate: 5
|
||||
enableGitInfo: true
|
||||
|
||||
taxonomies:
|
||||
_merge: deep
|
||||
|
||||
author:
|
||||
name: bbaovanc
|
||||
|
||||
markup: # this just keeps the bobatheme markup styling
|
||||
_merge: deep
|
||||
|
||||
params:
|
||||
# these are for the OpenGraph/Twitter embeds in Hugo
|
||||
description: My personal website
|
||||
|
||||
# these are for favicons in bobatheme (unset by default)
|
||||
faviconICO: favicon.ico
|
||||
faviconPNG: favicon.png
|
||||
|
||||
# show reading time (enabled by default)
|
||||
readingtime: true
|
||||
|
||||
# used for "View source" (unset by default)
|
||||
gitFileURL: https://github.com/BBaoVanC/bbaovanc.com/blob/master
|
||||
gitFileIcon: code
|
||||
|
||||
# see https://gohugo.io/about/hugo-and-gdpr/#all-privacy-settings
|
||||
# you probably want to keep this default
|
||||
privacy:
|
||||
_merge: deep
|
||||
|
||||
languages:
|
||||
en:
|
||||
languageName: English
|
||||
title: bbaovanc's Website
|
||||
weight: 1
|
||||
|
||||
es:
|
||||
languageName: Español
|
||||
title: sitio web de bbaovanc
|
||||
weight: 2
|
||||
params:
|
||||
description: Mi sitio web personal
|
431
content/LICENSE
Normal file
@ -0,0 +1,431 @@
|
||||
As stated in /LICENSE at the root of this repository, my website's
|
||||
content is licensed under CC-BY-SA 4.0:
|
||||
|
||||
|
||||
Attribution-ShareAlike 4.0 International
|
||||
|
||||
=======================================================================
|
||||
|
||||
Creative Commons Corporation ("Creative Commons") is not a law firm and
|
||||
does not provide legal services or legal advice. Distribution of
|
||||
Creative Commons public licenses does not create a lawyer-client or
|
||||
other relationship. Creative Commons makes its licenses and related
|
||||
information available on an "as-is" basis. Creative Commons gives no
|
||||
warranties regarding its licenses, any material licensed under their
|
||||
terms and conditions, or any related information. Creative Commons
|
||||
disclaims all liability for damages resulting from their use to the
|
||||
fullest extent possible.
|
||||
|
||||
Using Creative Commons Public Licenses
|
||||
|
||||
Creative Commons public licenses provide a standard set of terms and
|
||||
conditions that creators and other rights holders may use to share
|
||||
original works of authorship and other material subject to copyright
|
||||
and certain other rights specified in the public license below. The
|
||||
following considerations are for informational purposes only, are not
|
||||
exhaustive, and do not form part of our licenses.
|
||||
|
||||
Considerations for licensors: Our public licenses are
|
||||
intended for use by those authorized to give the public
|
||||
permission to use material in ways otherwise restricted by
|
||||
copyright and certain other rights. Our licenses are
|
||||
irrevocable. Licensors should read and understand the terms
|
||||
and conditions of the license they choose before applying it.
|
||||
Licensors should also secure all rights necessary before
|
||||
applying our licenses so that the public can reuse the
|
||||
material as expected. Licensors should clearly mark any
|
||||
material not subject to the license. This includes other CC-
|
||||
licensed material, or material used under an exception or
|
||||
limitation to copyright. More considerations for licensors:
|
||||
wiki.creativecommons.org/Considerations_for_licensors
|
||||
|
||||
Considerations for the public: By using one of our public
|
||||
licenses, a licensor grants the public permission to use the
|
||||
licensed material under specified terms and conditions. If
|
||||
the licensor's permission is not necessary for any reason--for
|
||||
example, because of any applicable exception or limitation to
|
||||
copyright--then that use is not regulated by the license. Our
|
||||
licenses grant only permissions under copyright and certain
|
||||
other rights that a licensor has authority to grant. Use of
|
||||
the licensed material may still be restricted for other
|
||||
reasons, including because others have copyright or other
|
||||
rights in the material. A licensor may make special requests,
|
||||
such as asking that all changes be marked or described.
|
||||
Although not required by our licenses, you are encouraged to
|
||||
respect those requests where reasonable. More considerations
|
||||
for the public:
|
||||
wiki.creativecommons.org/Considerations_for_licensees
|
||||
|
||||
=======================================================================
|
||||
|
||||
Creative Commons Attribution-ShareAlike 4.0 International Public
|
||||
License
|
||||
|
||||
By exercising the Licensed Rights (defined below), You accept and agree
|
||||
to be bound by the terms and conditions of this Creative Commons
|
||||
Attribution-ShareAlike 4.0 International Public License ("Public
|
||||
License"). To the extent this Public License may be interpreted as a
|
||||
contract, You are granted the Licensed Rights in consideration of Your
|
||||
acceptance of these terms and conditions, and the Licensor grants You
|
||||
such rights in consideration of benefits the Licensor receives from
|
||||
making the Licensed Material available under these terms and
|
||||
conditions.
|
||||
|
||||
|
||||
Section 1 -- Definitions.
|
||||
|
||||
a. Adapted Material means material subject to Copyright and Similar
|
||||
Rights that is derived from or based upon the Licensed Material
|
||||
and in which the Licensed Material is translated, altered,
|
||||
arranged, transformed, or otherwise modified in a manner requiring
|
||||
permission under the Copyright and Similar Rights held by the
|
||||
Licensor. For purposes of this Public License, where the Licensed
|
||||
Material is a musical work, performance, or sound recording,
|
||||
Adapted Material is always produced where the Licensed Material is
|
||||
synched in timed relation with a moving image.
|
||||
|
||||
b. Adapter's License means the license You apply to Your Copyright
|
||||
and Similar Rights in Your contributions to Adapted Material in
|
||||
accordance with the terms and conditions of this Public License.
|
||||
|
||||
c. BY-SA Compatible License means a license listed at
|
||||
creativecommons.org/compatiblelicenses, approved by Creative
|
||||
Commons as essentially the equivalent of this Public License.
|
||||
|
||||
d. Copyright and Similar Rights means copyright and/or similar rights
|
||||
closely related to copyright including, without limitation,
|
||||
performance, broadcast, sound recording, and Sui Generis Database
|
||||
Rights, without regard to how the rights are labeled or
|
||||
categorized. For purposes of this Public License, the rights
|
||||
specified in Section 2(b)(1)-(2) are not Copyright and Similar
|
||||
Rights.
|
||||
|
||||
e. Effective Technological Measures means those measures that, in the
|
||||
absence of proper authority, may not be circumvented under laws
|
||||
fulfilling obligations under Article 11 of the WIPO Copyright
|
||||
Treaty adopted on December 20, 1996, and/or similar international
|
||||
agreements.
|
||||
|
||||
f. Exceptions and Limitations means fair use, fair dealing, and/or
|
||||
any other exception or limitation to Copyright and Similar Rights
|
||||
that applies to Your use of the Licensed Material.
|
||||
|
||||
g. License Elements means the license attributes listed in the name
|
||||
of a Creative Commons Public License. The License Elements of this
|
||||
Public License are Attribution and ShareAlike.
|
||||
|
||||
h. Licensed Material means the artistic or literary work, database,
|
||||
or other material to which the Licensor applied this Public
|
||||
License.
|
||||
|
||||
i. Licensed Rights means the rights granted to You subject to the
|
||||
terms and conditions of this Public License, which are limited to
|
||||
all Copyright and Similar Rights that apply to Your use of the
|
||||
Licensed Material and that the Licensor has authority to license.
|
||||
|
||||
j. Licensor means the individual(s) or entity(ies) granting rights
|
||||
under this Public License.
|
||||
|
||||
k. Share means to provide material to the public by any means or
|
||||
process that requires permission under the Licensed Rights, such
|
||||
as reproduction, public display, public performance, distribution,
|
||||
dissemination, communication, or importation, and to make material
|
||||
available to the public including in ways that members of the
|
||||
public may access the material from a place and at a time
|
||||
individually chosen by them.
|
||||
|
||||
l. Sui Generis Database Rights means rights other than copyright
|
||||
resulting from Directive 96/9/EC of the European Parliament and of
|
||||
the Council of 11 March 1996 on the legal protection of databases,
|
||||
as amended and/or succeeded, as well as other essentially
|
||||
equivalent rights anywhere in the world.
|
||||
|
||||
m. You means the individual or entity exercising the Licensed Rights
|
||||
under this Public License. Your has a corresponding meaning.
|
||||
|
||||
|
||||
Section 2 -- Scope.
|
||||
|
||||
a. License grant.
|
||||
|
||||
1. Subject to the terms and conditions of this Public License,
|
||||
the Licensor hereby grants You a worldwide, royalty-free,
|
||||
non-sublicensable, non-exclusive, irrevocable license to
|
||||
exercise the Licensed Rights in the Licensed Material to:
|
||||
|
||||
a. reproduce and Share the Licensed Material, in whole or
|
||||
in part; and
|
||||
|
||||
b. produce, reproduce, and Share Adapted Material.
|
||||
|
||||
2. Exceptions and Limitations. For the avoidance of doubt, where
|
||||
Exceptions and Limitations apply to Your use, this Public
|
||||
License does not apply, and You do not need to comply with
|
||||
its terms and conditions.
|
||||
|
||||
3. Term. The term of this Public License is specified in Section
|
||||
6(a).
|
||||
|
||||
4. Media and formats; technical modifications allowed. The
|
||||
Licensor authorizes You to exercise the Licensed Rights in
|
||||
all media and formats whether now known or hereafter created,
|
||||
and to make technical modifications necessary to do so. The
|
||||
Licensor waives and/or agrees not to assert any right or
|
||||
authority to forbid You from making technical modifications
|
||||
necessary to exercise the Licensed Rights, including
|
||||
technical modifications necessary to circumvent Effective
|
||||
Technological Measures. For purposes of this Public License,
|
||||
simply making modifications authorized by this Section 2(a)
|
||||
(4) never produces Adapted Material.
|
||||
|
||||
5. Downstream recipients.
|
||||
|
||||
a. Offer from the Licensor -- Licensed Material. Every
|
||||
recipient of the Licensed Material automatically
|
||||
receives an offer from the Licensor to exercise the
|
||||
Licensed Rights under the terms and conditions of this
|
||||
Public License.
|
||||
|
||||
b. Additional offer from the Licensor -- Adapted Material.
|
||||
Every recipient of Adapted Material from You
|
||||
automatically receives an offer from the Licensor to
|
||||
exercise the Licensed Rights in the Adapted Material
|
||||
under the conditions of the Adapter's License You apply.
|
||||
|
||||
c. No downstream restrictions. You may not offer or impose
|
||||
any additional or different terms or conditions on, or
|
||||
apply any Effective Technological Measures to, the
|
||||
Licensed Material if doing so restricts exercise of the
|
||||
Licensed Rights by any recipient of the Licensed
|
||||
Material.
|
||||
|
||||
6. No endorsement. Nothing in this Public License constitutes or
|
||||
may be construed as permission to assert or imply that You
|
||||
are, or that Your use of the Licensed Material is, connected
|
||||
with, or sponsored, endorsed, or granted official status by,
|
||||
the Licensor or others designated to receive attribution as
|
||||
provided in Section 3(a)(1)(A)(i).
|
||||
|
||||
b. Other rights.
|
||||
|
||||
1. Moral rights, such as the right of integrity, are not
|
||||
licensed under this Public License, nor are publicity,
|
||||
privacy, and/or other similar personality rights; however, to
|
||||
the extent possible, the Licensor waives and/or agrees not to
|
||||
assert any such rights held by the Licensor to the limited
|
||||
extent necessary to allow You to exercise the Licensed
|
||||
Rights, but not otherwise.
|
||||
|
||||
2. Patent and trademark rights are not licensed under this
|
||||
Public License.
|
||||
|
||||
3. To the extent possible, the Licensor waives any right to
|
||||
collect royalties from You for the exercise of the Licensed
|
||||
Rights, whether directly or through a collecting society
|
||||
under any voluntary or waivable statutory or compulsory
|
||||
licensing scheme. In all other cases the Licensor expressly
|
||||
reserves any right to collect such royalties.
|
||||
|
||||
|
||||
Section 3 -- License Conditions.
|
||||
|
||||
Your exercise of the Licensed Rights is expressly made subject to the
|
||||
following conditions.
|
||||
|
||||
a. Attribution.
|
||||
|
||||
1. If You Share the Licensed Material (including in modified
|
||||
form), You must:
|
||||
|
||||
a. retain the following if it is supplied by the Licensor
|
||||
with the Licensed Material:
|
||||
|
||||
i. identification of the creator(s) of the Licensed
|
||||
Material and any others designated to receive
|
||||
attribution, in any reasonable manner requested by
|
||||
the Licensor (including by pseudonym if
|
||||
designated);
|
||||
|
||||
ii. a copyright notice;
|
||||
|
||||
iii. a notice that refers to this Public License;
|
||||
|
||||
iv. a notice that refers to the disclaimer of
|
||||
warranties;
|
||||
|
||||
v. a URI or hyperlink to the Licensed Material to the
|
||||
extent reasonably practicable;
|
||||
|
||||
b. indicate if You modified the Licensed Material and
|
||||
retain an indication of any previous modifications; and
|
||||
|
||||
c. indicate the Licensed Material is licensed under this
|
||||
Public License, and include the text of, or the URI or
|
||||
hyperlink to, this Public License.
|
||||
|
||||
2. You may satisfy the conditions in Section 3(a)(1) in any
|
||||
reasonable manner based on the medium, means, and context in
|
||||
which You Share the Licensed Material. For example, it may be
|
||||
reasonable to satisfy the conditions by providing a URI or
|
||||
hyperlink to a resource that includes the required
|
||||
information.
|
||||
|
||||
3. If requested by the Licensor, You must remove any of the
|
||||
information required by Section 3(a)(1)(A) to the extent
|
||||
reasonably practicable.
|
||||
|
||||
b. ShareAlike.
|
||||
|
||||
In addition to the conditions in Section 3(a), if You Share
|
||||
Adapted Material You produce, the following conditions also apply.
|
||||
|
||||
1. The Adapter's License You apply must be a Creative Commons
|
||||
license with the same License Elements, this version or
|
||||
later, or a BY-SA Compatible License.
|
||||
|
||||
2. You must include the text of, or the URI or hyperlink to, the
|
||||
Adapter's License You apply. You may satisfy this condition
|
||||
in any reasonable manner based on the medium, means, and
|
||||
context in which You Share Adapted Material.
|
||||
|
||||
3. You may not offer or impose any additional or different terms
|
||||
or conditions on, or apply any Effective Technological
|
||||
Measures to, Adapted Material that restrict exercise of the
|
||||
rights granted under the Adapter's License You apply.
|
||||
|
||||
|
||||
Section 4 -- Sui Generis Database Rights.
|
||||
|
||||
Where the Licensed Rights include Sui Generis Database Rights that
|
||||
apply to Your use of the Licensed Material:
|
||||
|
||||
a. for the avoidance of doubt, Section 2(a)(1) grants You the right
|
||||
to extract, reuse, reproduce, and Share all or a substantial
|
||||
portion of the contents of the database;
|
||||
|
||||
b. if You include all or a substantial portion of the database
|
||||
contents in a database in which You have Sui Generis Database
|
||||
Rights, then the database in which You have Sui Generis Database
|
||||
Rights (but not its individual contents) is Adapted Material,
|
||||
including for purposes of Section 3(b); and
|
||||
|
||||
c. You must comply with the conditions in Section 3(a) if You Share
|
||||
all or a substantial portion of the contents of the database.
|
||||
|
||||
For the avoidance of doubt, this Section 4 supplements and does not
|
||||
replace Your obligations under this Public License where the Licensed
|
||||
Rights include other Copyright and Similar Rights.
|
||||
|
||||
|
||||
Section 5 -- Disclaimer of Warranties and Limitation of Liability.
|
||||
|
||||
a. UNLESS OTHERWISE SEPARATELY UNDERTAKEN BY THE LICENSOR, TO THE
|
||||
EXTENT POSSIBLE, THE LICENSOR OFFERS THE LICENSED MATERIAL AS-IS
|
||||
AND AS-AVAILABLE, AND MAKES NO REPRESENTATIONS OR WARRANTIES OF
|
||||
ANY KIND CONCERNING THE LICENSED MATERIAL, WHETHER EXPRESS,
|
||||
IMPLIED, STATUTORY, OR OTHER. THIS INCLUDES, WITHOUT LIMITATION,
|
||||
WARRANTIES OF TITLE, MERCHANTABILITY, FITNESS FOR A PARTICULAR
|
||||
PURPOSE, NON-INFRINGEMENT, ABSENCE OF LATENT OR OTHER DEFECTS,
|
||||
ACCURACY, OR THE PRESENCE OR ABSENCE OF ERRORS, WHETHER OR NOT
|
||||
KNOWN OR DISCOVERABLE. WHERE DISCLAIMERS OF WARRANTIES ARE NOT
|
||||
ALLOWED IN FULL OR IN PART, THIS DISCLAIMER MAY NOT APPLY TO YOU.
|
||||
|
||||
b. TO THE EXTENT POSSIBLE, IN NO EVENT WILL THE LICENSOR BE LIABLE
|
||||
TO YOU ON ANY LEGAL THEORY (INCLUDING, WITHOUT LIMITATION,
|
||||
NEGLIGENCE) OR OTHERWISE FOR ANY DIRECT, SPECIAL, INDIRECT,
|
||||
INCIDENTAL, CONSEQUENTIAL, PUNITIVE, EXEMPLARY, OR OTHER LOSSES,
|
||||
COSTS, EXPENSES, OR DAMAGES ARISING OUT OF THIS PUBLIC LICENSE OR
|
||||
USE OF THE LICENSED MATERIAL, EVEN IF THE LICENSOR HAS BEEN
|
||||
ADVISED OF THE POSSIBILITY OF SUCH LOSSES, COSTS, EXPENSES, OR
|
||||
DAMAGES. WHERE A LIMITATION OF LIABILITY IS NOT ALLOWED IN FULL OR
|
||||
IN PART, THIS LIMITATION MAY NOT APPLY TO YOU.
|
||||
|
||||
c. The disclaimer of warranties and limitation of liability provided
|
||||
above shall be interpreted in a manner that, to the extent
|
||||
possible, most closely approximates an absolute disclaimer and
|
||||
waiver of all liability.
|
||||
|
||||
|
||||
Section 6 -- Term and Termination.
|
||||
|
||||
a. This Public License applies for the term of the Copyright and
|
||||
Similar Rights licensed here. However, if You fail to comply with
|
||||
this Public License, then Your rights under this Public License
|
||||
terminate automatically.
|
||||
|
||||
b. Where Your right to use the Licensed Material has terminated under
|
||||
Section 6(a), it reinstates:
|
||||
|
||||
1. automatically as of the date the violation is cured, provided
|
||||
it is cured within 30 days of Your discovery of the
|
||||
violation; or
|
||||
|
||||
2. upon express reinstatement by the Licensor.
|
||||
|
||||
For the avoidance of doubt, this Section 6(b) does not affect any
|
||||
right the Licensor may have to seek remedies for Your violations
|
||||
of this Public License.
|
||||
|
||||
c. For the avoidance of doubt, the Licensor may also offer the
|
||||
Licensed Material under separate terms or conditions or stop
|
||||
distributing the Licensed Material at any time; however, doing so
|
||||
will not terminate this Public License.
|
||||
|
||||
d. Sections 1, 5, 6, 7, and 8 survive termination of this Public
|
||||
License.
|
||||
|
||||
|
||||
Section 7 -- Other Terms and Conditions.
|
||||
|
||||
a. The Licensor shall not be bound by any additional or different
|
||||
terms or conditions communicated by You unless expressly agreed.
|
||||
|
||||
b. Any arrangements, understandings, or agreements regarding the
|
||||
Licensed Material not stated herein are separate from and
|
||||
independent of the terms and conditions of this Public License.
|
||||
|
||||
|
||||
Section 8 -- Interpretation.
|
||||
|
||||
a. For the avoidance of doubt, this Public License does not, and
|
||||
shall not be interpreted to, reduce, limit, restrict, or impose
|
||||
conditions on any use of the Licensed Material that could lawfully
|
||||
be made without permission under this Public License.
|
||||
|
||||
b. To the extent possible, if any provision of this Public License is
|
||||
deemed unenforceable, it shall be automatically reformed to the
|
||||
minimum extent necessary to make it enforceable. If the provision
|
||||
cannot be reformed, it shall be severed from this Public License
|
||||
without affecting the enforceability of the remaining terms and
|
||||
conditions.
|
||||
|
||||
c. No term or condition of this Public License will be waived and no
|
||||
failure to comply consented to unless expressly agreed to by the
|
||||
Licensor.
|
||||
|
||||
d. Nothing in this Public License constitutes or may be interpreted
|
||||
as a limitation upon, or waiver of, any privileges and immunities
|
||||
that apply to the Licensor or You, including from the legal
|
||||
processes of any jurisdiction or authority.
|
||||
|
||||
|
||||
=======================================================================
|
||||
|
||||
Creative Commons is not a party to its public
|
||||
licenses. Notwithstanding, Creative Commons may elect to apply one of
|
||||
its public licenses to material it publishes and in those instances
|
||||
will be considered the "Licensor." The text of the Creative Commons
|
||||
public licenses is dedicated to the public domain under the CC0 Public
|
||||
Domain Dedication. Except for the limited purpose of indicating that
|
||||
material is shared under a Creative Commons public license or as
|
||||
otherwise permitted by the Creative Commons policies published at
|
||||
creativecommons.org/policies, Creative Commons does not authorize the
|
||||
use of the trademark "Creative Commons" or any other trademark or logo
|
||||
of Creative Commons without its prior written consent including,
|
||||
without limitation, in connection with any unauthorized modifications
|
||||
to any of its public licenses or any other arrangements,
|
||||
understandings, or agreements concerning use of licensed material. For
|
||||
the avoidance of doubt, this paragraph does not form part of the
|
||||
public licenses.
|
||||
|
||||
Creative Commons may be contacted at creativecommons.org.
|
@ -3,22 +3,37 @@
|
||||
title: Home
|
||||
|
||||
description: >-
|
||||
This is my website, home to my blog and other personal pages. It's powered by
|
||||
my own custom theme named bobatheme, available at
|
||||
This is my personal website, home to my blog. It's powered by my own custom
|
||||
theme named bobatheme, which is available at
|
||||
https://github.com/BBaoVanC/bobatheme.
|
||||
|
||||
---
|
||||
|
||||
## My Website
|
||||
|
||||
This is my website. Pretty self-explanatory.
|
||||
This is my personal website. I wrote it myself from scratch using [my own
|
||||
theme][bobatheme-github] and a static site generator named [Hugo][hugo-website].
|
||||
I occasionally write blog posts under the [blog section][blog-section].
|
||||
|
||||
## A fresh new theme
|
||||
[bobatheme-github]: https://github.com/BBaoVanC/bobatheme
|
||||
[hugo-website]: https://gohugo.io
|
||||
[blog-section]: {{< ref "/blog/" >}}
|
||||
|
||||
My website uses my own custom theme named
|
||||
[bobatheme](https://github.com/BBaoVanC/bobatheme). Although it's not quite
|
||||
finished yet, the current style will probably stay for the forseeable future.
|
||||
## Contact
|
||||
|
||||
## Another website
|
||||
You can contact me by emailing bbaovanc@bbaovanc.com ([PGP key][pgp-key] if
|
||||
encryption is needed), or on Mastodon at
|
||||
[bbaovanc@procursus.social][mastodon-account] (but I have some plans to
|
||||
replace Mastodon... stay tuned).
|
||||
|
||||
I also run another website: https://boba.best.
|
||||
[pgp-key]: https://keyserver.ubuntu.com/pks/lookup?search=bbaovanc%40bbaovanc.com&fingerprint=on&op=index
|
||||
[mastodon-account]: https://procursus.social/@bbaovanc
|
||||
|
||||
## Topics I write about
|
||||
|
||||
I write mostly about technology, including:
|
||||
|
||||
- Linux
|
||||
- Open Source Software
|
||||
- Programming
|
||||
- Web Development
|
||||
|
8
content/authors/_index.md
Normal file
@ -0,0 +1,8 @@
|
||||
---
|
||||
|
||||
title: Authors
|
||||
|
||||
description: >-
|
||||
List of authors on my website.
|
||||
|
||||
---
|
@ -1,6 +1,7 @@
|
||||
---
|
||||
|
||||
title: bbaovanc
|
||||
issoUserID: 284513e38f5c
|
||||
|
||||
---
|
||||
|
||||
|
@ -1,6 +1,6 @@
|
||||
---
|
||||
|
||||
title: Github Copilot
|
||||
title: GitHub Copilot
|
||||
|
||||
---
|
||||
|
||||
|
@ -1,8 +0,0 @@
|
||||
---
|
||||
|
||||
title: Blog
|
||||
|
||||
description: >-
|
||||
El hogar de mi blog.
|
||||
|
||||
---
|
@ -3,6 +3,6 @@
|
||||
title: Blog
|
||||
|
||||
description: >-
|
||||
The home of my blog.
|
||||
The home of my blog. This is where all my articles go under.
|
||||
|
||||
---
|
||||
|
@ -2,29 +2,30 @@
|
||||
|
||||
title: Allow non root processes to bind to privileged ports in Linux
|
||||
date: 2021-03-28T21:29:52-05:00
|
||||
lastmod: 2022-05-02T01:05:44-05:00
|
||||
toc: true
|
||||
comments: true
|
||||
|
||||
authors:
|
||||
- bbaovanc
|
||||
|
||||
aliases:
|
||||
- posts/allow-non-root-processes-to-bind-to-privileged-ports/
|
||||
categories:
|
||||
- guides
|
||||
|
||||
tags:
|
||||
- guide
|
||||
- linux
|
||||
- systemd
|
||||
|
||||
---
|
||||
|
||||
In Linux, processes cannot bind to privileged ports (<=1024) unless they are
|
||||
In Linux, processes cannot bind to privileged ports (<=1024) unless they are
|
||||
running as root. Here's how to allow any process to bind to privileged ports.
|
||||
|
||||
<!--more-->
|
||||
|
||||
## Introduction
|
||||
|
||||
In Linux, processes cannot bind to privileged ports (<=1024) unless they are
|
||||
In Linux, processes cannot bind to privileged ports (<=1024) unless they are
|
||||
running as root. I learned about this when I was trying to add SSH cloning to my
|
||||
[Gitea](https://gitea.io) instance. This can be bypassed by giving
|
||||
`CAP_NET_BIND_SERVICE` capabilities to either the systemd service, or the
|
||||
@ -34,9 +35,9 @@ executable itself.
|
||||
|
||||
### Using systemd (preferred)
|
||||
|
||||
The best way is to tell systemd to give `CAP_NET_BIND_SERVICE`
|
||||
capabilities to the service. In fact, the Gitea systemd service has two
|
||||
lines[^1] that are commented out:
|
||||
The best way is to tell systemd to give `CAP_NET_BIND_SERVICE` capabilities to
|
||||
the service. In fact, the Gitea systemd service has two
|
||||
lines[^systemd-set-capabilities] that are commented out:
|
||||
|
||||
```systemd
|
||||
CapabilityBoundingSet=CAP_NET_BIND_SERVICE
|
||||
@ -48,7 +49,7 @@ Uncommenting these two lines was all I had to do for Gitea.
|
||||
### Using `setcap`
|
||||
|
||||
You can add `CAP_NET_BIND_SERVICE` to the executable directly using `setcap`,
|
||||
allowing it to bind to any port. Run the following command[^2]:
|
||||
allowing it to bind to any port. Run the following command[^setcap-command]:
|
||||
|
||||
```bash
|
||||
setcap 'cap_net_bind_service=+ep' /path/to/program
|
||||
@ -57,7 +58,7 @@ setcap 'cap_net_bind_service=+ep' /path/to/program
|
||||
Note that this means that anyone with permission to run this program will be
|
||||
able to run it and bind to any privileged ports.
|
||||
|
||||
Other caveats[^2]:
|
||||
Other caveats[^caveats-quote]:
|
||||
|
||||
> 1. You will need at least a 2.6.24 kernel
|
||||
> 2. This won't work if your file is a script. (ie, uses a #! line to launch an
|
||||
@ -70,6 +71,10 @@ Other caveats[^2]:
|
||||
> privileges like setcap or suid. So if your program uses its own .../lib/,
|
||||
> you might have to look into another option like port forwarding.
|
||||
|
||||
[^1]: https://github.com/go-gitea/gitea/blob/3416e2a82586fca4cd452b93237b979300f55d62/contrib/systemd/gitea.service#L69
|
||||
and https://stackoverflow.com/a/47065825
|
||||
[^2]: https://stackoverflow.com/a/414258
|
||||
|
||||
[^systemd-set-capabilities]: See [these two lines in the Gitea systemd service
|
||||
file](https://github.com/go-gitea/gitea/blob/3416e2a82586fca4cd452b93237b979300f55d62/contrib/systemd/gitea.service#L69)
|
||||
and [this Stack Overflow answer](https://stackoverflow.com/a/47065825).
|
||||
|
||||
[^setcap-command]: https://stackoverflow.com/a/414258
|
||||
[^caveats-quote]: https://stackoverflow.com/a/414258
|
||||
|
After Width: | Height: | Size: 14 KiB |
@ -0,0 +1,144 @@
|
||||
---
|
||||
|
||||
title: Using GitHub Actions to audit my website with Google Chrome Lighthouse
|
||||
date: 2022-05-07T00:54:11-05:00
|
||||
lastmod: 2022-05-08T16:16:02-05:00
|
||||
toc: true
|
||||
comments: true
|
||||
|
||||
authors:
|
||||
- bbaovanc
|
||||
|
||||
categories:
|
||||
- meta
|
||||
|
||||
tags:
|
||||
- caddy
|
||||
- devops
|
||||
- github-actions
|
||||
- google-lighthouse
|
||||
|
||||
# this will be shown for the article in list pages and in the page metadata
|
||||
# it can be either an image or video (this might change in the future, however)
|
||||
resources:
|
||||
- name: feature
|
||||
src: dashboard-performance-graph.webp
|
||||
title: Picture of the `Performance` section on the Lighthouse CI dashboard
|
||||
|
||||
- name: youtube-embed-performance-comparison
|
||||
src: youtube-embed-performance-comparison.webp
|
||||
title: >-
|
||||
Performance hit caused by adding a YouTube embed. You can see the
|
||||
comparison itself [on this comparison
|
||||
page](https://lhci.bbaovanc.com/app/projects/bbaovanc.com/compare/01d2064b6fac?baseUrl=https%3A%2F%2Flocalhost%2Fblog%2Fthe-redesign-of-my-website%2F&compareUrl=https%3A%2F%2Flocalhost%2Fblog%2Fyoutube-url-structures-you-should-know%2F&baseBuild=01d2064b-6fac-40df-b4e6-373037ae1f9e).
|
||||
|
||||
---
|
||||
|
||||
The other day I set up automatic testing of my website using [Google Chrome
|
||||
Lighthouse][google-lighthouse]. I'm also running my own Lighthouse CI server to
|
||||
store test result history and show trends. Here's an outline of what this means,
|
||||
some of the results I've obtained so far, and my thoughts on the usefulness of
|
||||
Lighthouse.
|
||||
|
||||
[google-lighthouse]: https://developers.google.com/web/tools/lighthouse
|
||||
|
||||
<!--more-->
|
||||
|
||||
## What is Lighthouse?
|
||||
|
||||
Lighthouse is a tool developed by Google which audits websites and gives them a
|
||||
score in four categories: *Performance*, *Accessibility*, *Best Practices*, and
|
||||
*SEO (search engine optimization)*. It's also built into the developer console
|
||||
in Chrome, so you can run it manually on any website you want directly inside
|
||||
your browser.
|
||||
|
||||
I have already been using Lighthouse manually to do occasional tests on my
|
||||
website and its theme, [bobatheme][bobatheme]. However, I recently came across
|
||||
[this GitHub Action][lhci-action]. It caught my eye because I was [already using
|
||||
GitHub Actions][old-audit-workflow] to perform a few basic Hugo[^hugo]-related
|
||||
audits found [in a thread on the Hugo forum][hugo-audits-thread].
|
||||
|
||||
[^hugo]: [Hugo](https://gohugo.io) is the framework that my website is built on. It's
|
||||
a static site generator which generates my site according to my own custom
|
||||
templates that make up my theme.
|
||||
|
||||
[bobatheme]: https://github.com/BBaoVanC/bobatheme
|
||||
[lhci-action]: https://github.com/marketplace/actions/lighthouse-ci-action
|
||||
[old-audit-workflow]: https://github.com/BBaoVanC/bbaovanc.com/blob/31e25c2578a789afe71ce90352747eb427ca3c0e/.github/workflows/audit.yml#L31-L59
|
||||
[hugo-audits-thread]: https://discourse.gohugo.io/t/audit-your-published-site-for-problems/35184
|
||||
|
||||
## Setting it all up
|
||||
|
||||
My goal is to run Lighthouse's audits on an environment as similar to my real
|
||||
website's deployment as possible.
|
||||
|
||||
First, I [created a separate `lighthouse` job on my audit
|
||||
workflow][lighthouse-actions-job] on GitHub Actions. This job will do all of the
|
||||
testing. Since it's a separate job, it runs in parallel with my existing audit
|
||||
task.
|
||||
|
||||
[lighthouse-actions-job]: https://github.com/BBaoVanC/bbaovanc.com/blob/3668b6cfb11d09149b5da347219cdc75d0ce0985/.github/workflows/audit.yml#L7
|
||||
|
||||
Next, I copied [my existing build steps verbatim][production-build-steps]. This
|
||||
makes the site effectively identical to my real deployment on bbaovanc.com. One
|
||||
of the crucial steps is to pre-compress all the files so their compressed
|
||||
versions can be served without the server having to compress them on-the-fly,
|
||||
saving valuable processing power.
|
||||
|
||||
[production-build-steps]: https://github.com/BBaoVanC/bbaovanc.com/blob/db65e9fc23b840429f5c9ad2b43d7dd01a024f36/.github/workflows/deploy.yml#L22-L33
|
||||
|
||||
Serving the compressed files is crucial because it simulates the real world
|
||||
transfer size of the files. In addition, Lighthouse will recommend that you
|
||||
serve the files compressed.
|
||||
|
||||
Inside the audit environment I use the same webserver (Caddy) and a [similar
|
||||
configuration][audit-caddy-config] (compared to the [one running on
|
||||
bbaovanc.com][production-caddy-config]) to what I have running on bbaovanc.com.
|
||||
Caddy also is able to easily run the demo site with HTTPS, even on localhost.
|
||||
That allows it to test certain elements (such as the comment section) that
|
||||
wouldn't be allowed to load if it were plain, unsecured HTTP.
|
||||
|
||||
[audit-caddy-config]: https://github.com/BBaoVanC/bbaovanc.com/blob/3668b6cfb11d09149b5da347219cdc75d0ce0985/Caddyfile
|
||||
[production-caddy-config]: https://git.bbaovanc.com/configs/caddy/src/commit/e3227eb2a2679e27545c2417c2565941f03fb744/conf.d/bbaovanc.com
|
||||
|
||||
{{< see-also "/blog/caddy-is-the-best-webserver" >}}
|
||||
|
||||
I selected [a few significant pages on my website][lighthouse-urls] so
|
||||
Lighthouse can test a wide range of the features in my website's theme. The
|
||||
results of these tests are then uploaded to [my Lighthouse CI
|
||||
server][lhci-dashboard]. There you can view the audit history and see
|
||||
differences in results between builds.
|
||||
|
||||
[lighthouse-urls]: https://github.com/BBaoVanC/bbaovanc.com/blob/3668b6cfb11d09149b5da347219cdc75d0ce0985/lighthouserc.yaml#L4-L19
|
||||
[lhci-dashboard]: https://lhci.bbaovanc.com/app/projects/bbaovanc.com/dashboard
|
||||
|
||||
## What I found from the tests
|
||||
|
||||
### Performance impact of a YouTube video
|
||||
|
||||
I found that embedding a YouTube video using the built-in shortcode in Hugo
|
||||
made the website drastically slower. It's a lot clearer in the audit environment
|
||||
where everything is throttled down a bunch, so the performance impact is more
|
||||
clear. Below is a screenshot of the difference in score between my blog post
|
||||
with a YouTube embed and a similarly sized blog post which has no video.
|
||||
|
||||
{{< figure src="youtube-embed-performance-comparison" >}}
|
||||
|
||||
I can probably optimize this a little by making a copy of the built-in Hugo
|
||||
YouTube shortcode, and modifying it to defer the loading of the remote scripts.
|
||||
That will have to be a future project, and I'll probably write a post if I ever
|
||||
end up testing it.
|
||||
|
||||
## My thoughts on Lighthouse
|
||||
|
||||
You can make the argument that the results from Lighthouse don't really mean
|
||||
much in the real world. On modern devices and a decent internet speed most
|
||||
websites will load just fine.
|
||||
|
||||
Although most pages on my site have a perfect score from Lighthouse, I'm not
|
||||
going to go way out of my way in order to keep it that way. After all,
|
||||
Lighthouse is just a tool intended for "improving the quality of web
|
||||
pages."[^improve-quality-quote] That doesn't mean it needs to be perfect.
|
||||
|
||||
[^improve-quality-quote]: Source: [Google
|
||||
Developers](https://developers.google.com/web/tools/lighthouse)
|
After Width: | Height: | Size: 33 KiB |
102
content/blog/blog-post-newsletter/index.md
Normal file
@ -0,0 +1,102 @@
|
||||
---
|
||||
|
||||
title: Newsletter for my blog posts
|
||||
date: 2022-04-30T01:00:14-05:00
|
||||
lastmod: 2022-05-23T02:17:47-05:00
|
||||
toc: true
|
||||
comments: true
|
||||
|
||||
authors:
|
||||
- bbaovanc
|
||||
|
||||
categories:
|
||||
- meta
|
||||
|
||||
tags:
|
||||
|
||||
# this will be shown for the article in list pages and in the page metadata
|
||||
# it can be either an image or video (this might change in the future, however)
|
||||
resources:
|
||||
- name: feature
|
||||
src: listmonk-bobatheme-template.webp
|
||||
title: My custom newsletter template based on my website's custom theme.
|
||||
|
||||
- name: listmonk-splash
|
||||
src: listmonk-splash.webp
|
||||
title: >-
|
||||
Dashboard on listmonk ---
|
||||
[source](https://listmonk.app/static/images/splash.png)
|
||||
|
||||
---
|
||||
|
||||
I created a newsletter for blog posts on my website so you can sign up for email
|
||||
notifications when I post new ones, so I have more than just an RSS feed.
|
||||
|
||||
<!--more-->
|
||||
|
||||
{{< aside warning >}}
|
||||
I decided that I didn't really want to deal with the extra work of managing a
|
||||
newsletter so I've removed it. (I didn't actually get any sign-ups).
|
||||
{{< /aside >}}
|
||||
|
||||
**See the ["Signing Up" section]({{< ref "#signing-up" >}}) for instructions on
|
||||
how to sign up for the newsletter.**
|
||||
|
||||
## Choosing the right mailing list manager
|
||||
|
||||
For my newsletter manager, I chose [listmonk](https://listmonk.app/). As I was
|
||||
searching for self-hosted newsletter managers, it caught my eye because of how
|
||||
modern and beautiful its interface looks. In fact, it was the only self-hosted
|
||||
newsletter/mailing list manager I looked at that doesn't have an overall old and
|
||||
ugly interface. Additionally, it has a live demo, so I was able to test it out
|
||||
and see if it would be able to meet my (relatively low) requirements.
|
||||
|
||||
{{< figure src="listmonk-splash" >}}
|
||||
|
||||
I also tried out [GNU Mailman 3](https://www.list.org/) about a year ago.
|
||||
However, I could not get it to integrate cleanly with my email
|
||||
server[^mailman-mailcow]. listmonk can operate over SMTP, just like any other
|
||||
program that sends mail. That makes the setup much less complicated, and I was
|
||||
also able to set up the [official Docker
|
||||
image](https://listmonk.app/docs/installation/#docker) using Docker Compose
|
||||
setup just like the other programs I use.
|
||||
|
||||
If you're interested, the Docker Compose configuration files I ended up writing
|
||||
are available at [configs/listmonk on my Gitea
|
||||
instance](https://git.bbaovanc.com/configs/listmonk).
|
||||
|
||||
## Newsletter formatting
|
||||
|
||||
I ended up writing my own template for listmonk from scratch, based on the CSS
|
||||
used in [bobatheme](https://github.com/BBaoVanC/bobatheme), the theme that my
|
||||
website uses. Here's a screenshot of how it currently looks:
|
||||
|
||||
{{< figure src="feature" >}}
|
||||
|
||||
## Signing up
|
||||
|
||||
{{< aside warning >}}
|
||||
I decided that I didn't really want to deal with the extra work of managing a
|
||||
newsletter so I've removed it. (I didn't actually get any sign-ups anyways.)
|
||||
{{< /aside >}}
|
||||
|
||||
You can sign up to get emails about new posts on the [newsletter signup form
|
||||
here](https://lists.bbaovanc.com/subscription/form). Make sure the box next to
|
||||
the list labeled `bbaovanc.com Blog Posts` is checked. You'll need to provide an
|
||||
email address, and optionally a nickname (or your real name if you want).
|
||||
|
||||
Right now there's only one list with public signup enabled, but that may change
|
||||
if you're reading this in the future. In that case, you can sign up for as many
|
||||
or as few lists as you want.
|
||||
|
||||
|
||||
|
||||
[^mailman-mailcow]: Mailman requires access to the mail server over
|
||||
[LMTP](https://en.wikipedia.org/wiki/Local_Mail_Transfer_Protocol). However,
|
||||
giving it access to my mail server over LMTP is not very easy because of the
|
||||
setup that [Mailcow](https://mailcow.email) (my email server) uses. There *is*
|
||||
an existing project called
|
||||
[dockerized-mailcow-mailman](https://github.com/g4rf/dockerized-mailcow-mailman),
|
||||
but it uses the Apache web server to serve the frontend. I'm not familiar with
|
||||
Apache, and also I don't really want to complicate my Mailcow setup switching
|
||||
to an almost completely different setup just for one little program.
|
After Width: | Height: | Size: 13 KiB |
BIN
content/blog/blog-post-newsletter/listmonk-splash.webp
Normal file
After Width: | Height: | Size: 24 KiB |
@ -2,16 +2,21 @@
|
||||
|
||||
title: Caddy is literally the best webserver
|
||||
date: 2021-11-13T00:43:35-06:00
|
||||
lastmod: 2023-01-16T20:57:00-06:00
|
||||
toc: true
|
||||
comments: true
|
||||
|
||||
authors:
|
||||
- bbaovanc
|
||||
|
||||
categories:
|
||||
- reviews
|
||||
|
||||
tags:
|
||||
- linux
|
||||
- webserver
|
||||
- caddy
|
||||
- linux
|
||||
- sysadmin
|
||||
- webserver
|
||||
|
||||
resources:
|
||||
- name: feature
|
||||
@ -37,14 +42,14 @@ for general use.
|
||||
## Built-in automatic HTTPS
|
||||
|
||||
Caddy can fetch certificates from Let's Encrypt and ZeroSSL out of the box.
|
||||
HTTPS is enabled by default for eligible domains[^1], unless you explicitly tell
|
||||
it not to.
|
||||
HTTPS is enabled by default for eligible domains[^hostname-requirements], unless
|
||||
you explicitly tell it not to.
|
||||
|
||||
### Incredible cipher security
|
||||
|
||||
Caddy has incredible defaults for TLS/SSL ciphers. Any site you host on Caddy
|
||||
gets a perfect score from [Qualys SSL Labs](https://www.ssllabs.com/ssltest/)
|
||||
out of the box.[^2]
|
||||
out of the box.[^caddy-qualys-score]
|
||||
|
||||
## Dead simple configuration files: Caddy vs NGINX
|
||||
|
||||
@ -90,9 +95,9 @@ configs.
|
||||
### PHP (PrivateBin)
|
||||
|
||||
The Caddy config for this example is the same as the [one used for
|
||||
bin.boba.best](https://git.boba.best/configs/caddy/src/commit/cd00151fbdd784979a8a181980cc36061be68c7d/conf.d/bin.boba.best).
|
||||
bin.boba.best](https://git.boba.best/boba.best/caddy/src/commit/cd00151fbdd784979a8a181980cc36061be68c7d/conf.d/bin.boba.best).
|
||||
I've stripped it down a bit by removing the [custom error
|
||||
pages](https://git.boba.best/configs/caddy/src/commit/cd00151fbdd784979a8a181980cc36061be68c7d/Caddyfile#L15-L24),
|
||||
pages](https://git.boba.best/boba.best/caddy/src/commit/cd00151fbdd784979a8a181980cc36061be68c7d/Caddyfile#L15-L24),
|
||||
[HSTS](https://en.wikipedia.org/wiki/HTTP_Strict_Transport_Security), [zstd
|
||||
compression](https://github.com/facebook/zstd), and logging.
|
||||
|
||||
@ -132,7 +137,7 @@ server {
|
||||
### Reverse proxy + static files (Gitea)
|
||||
|
||||
This last example is based on
|
||||
[git.bbaovanc.com](https://git.bbaovanc.com/configs/caddy/src/commit/57c9f0011eae92ef5fa2992d99f01b0956802d64/conf.d/git.bbaovanc.com).
|
||||
[git.bbaovanc.com](https://git.bbaovanc.com/boba.best/caddy/src/commit/57c9f0011eae92ef5fa2992d99f01b0956802d64/conf.d/git.bbaovanc.com).
|
||||
Just like the last example, I've stripped off the custom error pages, HSTS, zstd
|
||||
compression, and logging.
|
||||
|
||||
@ -194,12 +199,12 @@ templates](https://pkg.go.dev/text/template). This means you can make simple
|
||||
dynamic content while only using Caddy!
|
||||
|
||||
In fact, the [official Caddy website](https://caddyserver.com) is generated
|
||||
entirely using Caddy's and Go templates![^3]
|
||||
entirely using Caddy's and Go templates![^caddy-templating]
|
||||
|
||||
#### Error pages using HTTP Cats
|
||||
|
||||
I use [this
|
||||
snippet](https://git.bbaovanc.com/configs/caddy/src/commit/57c9f0011eae92ef5fa2992d99f01b0956802d64/Caddyfile#L8-L15)
|
||||
snippet](https://git.bbaovanc.com/boba.best/caddy/src/commit/57c9f0011eae92ef5fa2992d99f01b0956802d64/Caddyfile#L8-L15)
|
||||
on both bbaovanc.com and boba.best to make custom error pages using images from
|
||||
[HTTP Cats](https://http.cat). It uses Caddy's template support to generate some
|
||||
simple HTML to show the error code, name, and cat image.
|
||||
@ -217,12 +222,14 @@ border around the image.
|
||||
{{< figure src="caddy-browse" >}}
|
||||
|
||||
|
||||
[^1]: The rules for what domains have automatic HTTPS by default are
|
||||
[here](https://caddyserver.com/docs/automatic-https#hostname-requirements)
|
||||
[^hostname-requirements]: For the rules on what domains have automatic HTTPS by
|
||||
default, see ["Hostname requirements" on the Caddy
|
||||
documentation](https://caddyserver.com/docs/automatic-https#hostname-requirements).
|
||||
|
||||
[^2]: SSL Labs caps the score to an A if HSTS isn't enabled. After enabling it,
|
||||
then you get a perfect A+ score. See
|
||||
https://www.ssllabs.com/ssltest/analyze.html?d=bbaovanc.com&latest
|
||||
[^caddy-qualys-score]: SSL Labs caps the score to an A if HSTS isn't enabled.
|
||||
After enabling it, then you get a perfect A+ score. See [my website's
|
||||
score](https://www.ssllabs.com/ssltest/analyze.html?d=bbaovanc.com&latest)
|
||||
([archived](https://archive.today/4JJDN)) for an example (bbaovanc.com).
|
||||
|
||||
[^3]: See more info [on the Caddy docs](https://caddyserver.com/docs/caddyfile/directives/templates#examples)
|
||||
[^caddy-templating]: See more info about templating [on the Caddy
|
||||
docs](https://caddyserver.com/docs/caddyfile/directives/templates#examples)
|
||||
|
Before Width: | Height: | Size: 15 KiB After Width: | Height: | Size: 12 KiB |
@ -2,21 +2,18 @@
|
||||
|
||||
title: Checkra1n GUI on other Linux distros
|
||||
date: 2021-03-25T21:19:51-05:00
|
||||
lastmod: 2021-10-16T21:25:38-05:00
|
||||
toc: true
|
||||
comments: true
|
||||
|
||||
authors:
|
||||
- bbaovanc
|
||||
|
||||
aliases:
|
||||
- posts/checkra1n-gui-on-other-distros/
|
||||
categories:
|
||||
- guides
|
||||
|
||||
tags:
|
||||
- guide
|
||||
- linux
|
||||
- archlinux
|
||||
- jailbreak
|
||||
- checkra1n
|
||||
|
||||
resources:
|
||||
- name: feature
|
||||
|
@ -2,19 +2,24 @@
|
||||
|
||||
# this is the title it generated. not even joking
|
||||
title: Copilot
|
||||
date: 2021-11-07T16:17:15-06:00
|
||||
date: 2021-11-07T16:20:15-06:00
|
||||
lastmod: 2021-11-07T16:20:15-06:00
|
||||
toc: true
|
||||
comments: true
|
||||
|
||||
authors:
|
||||
- GitHub Copilot
|
||||
- bbaovanc
|
||||
|
||||
categories:
|
||||
|
||||
tags:
|
||||
- github-copilot
|
||||
|
||||
series:
|
||||
- GitHub Copilot Experiments
|
||||
- github-copilot-experiments
|
||||
|
||||
_build:
|
||||
list: never
|
||||
|
||||
---
|
||||
|
||||
|
BIN
content/blog/discord-sex-hack/6969th.webp
Normal file
After Width: | Height: | Size: 24 KiB |
BIN
content/blog/discord-sex-hack/chess.webp
Normal file
After Width: | Height: | Size: 16 KiB |
BIN
content/blog/discord-sex-hack/default-sex.webp
Normal file
After Width: | Height: | Size: 29 KiB |
BIN
content/blog/discord-sex-hack/double-sex.webp
Normal file
After Width: | Height: | Size: 139 KiB |
BIN
content/blog/discord-sex-hack/example.webp
Normal file
After Width: | Height: | Size: 56 KiB |
297
content/blog/discord-sex-hack/index.md
Normal file
@ -0,0 +1,297 @@
|
||||
---
|
||||
|
||||
title: How the "Discord sex" (`s/e/x`) hack works
|
||||
date: 2022-05-11T21:11:17-05:00
|
||||
lastmod: 2022-09-24T14:56:05-05:00
|
||||
toc: true
|
||||
comments: true
|
||||
|
||||
authors:
|
||||
- bbaovanc
|
||||
|
||||
categories:
|
||||
- tips-and-tricks
|
||||
|
||||
tags:
|
||||
- discord
|
||||
- discord-tricks
|
||||
- sed
|
||||
|
||||
# this will be shown for the article in list pages and in the page metadata
|
||||
# it can be either an image or video (this might change in the future, however)
|
||||
resources:
|
||||
- name: feature
|
||||
src: example.webp
|
||||
title: Result after sending a GIF and then sending `s/e/x`.
|
||||
|
||||
- name: default-sex
|
||||
src: default-sex.webp
|
||||
title: Fallback image on `txnor.com`
|
||||
|
||||
- name: double-sex
|
||||
src: double-sex.webp
|
||||
title: Resulting image after typing `s/e/x` a second time.
|
||||
|
||||
- name: chess
|
||||
src: chess.webp
|
||||
title: This happens once you type `s/w/ag` after having done `s/e/x`.
|
||||
|
||||
- name: sword
|
||||
src: sword.webp
|
||||
title: This happens when you type `s/w/ord` after having done `s/e/x`.
|
||||
- name: sword-atk
|
||||
src: sword-atk.webp
|
||||
title: This happens when you type `s/d/dATK`
|
||||
- name: sword-def
|
||||
src: sword-def.webp
|
||||
title: This happens when you type `s/d/dDEF`
|
||||
- name: sword-hug
|
||||
src: sword-hug.webp
|
||||
title: This happens when you type `s/d/dHUG`
|
||||
- name: sword-win
|
||||
src: sword-win.webp
|
||||
title: Win screen on the `s/w/ord` game.
|
||||
- name: sword-lose
|
||||
src: sword-lose.webp
|
||||
title: Lose screen on the `s/w/ord` game.
|
||||
|
||||
- name: 6969th
|
||||
src: 6969th.webp
|
||||
title: This happens on average (since it's randomized) every 6070th use.
|
||||
|
||||
- name: math-challenge
|
||||
src: math-challenge.webp
|
||||
title: Math challenge example
|
||||
|
||||
---
|
||||
|
||||
There's this trick going around on Discord recently where if you send any GIF
|
||||
from Tenor, and then type `s/e/x`, then it turns it into a different meme GIF.
|
||||
Here's how it works.
|
||||
|
||||
<!--more-->
|
||||
|
||||
{{< aside info >}}
|
||||
Credit goes to Rebane2001 (not me) for making this trick, and setting it up on
|
||||
`txnor.com`.
|
||||
{{< /aside >}}
|
||||
|
||||
## The `sed` syntax
|
||||
|
||||
For operating systems based on Unix or Linux, there's usually a simple terminal
|
||||
command included called [`sed`][sed-wikipedia], which is most commonly used to
|
||||
run text replacement commands. Here's a very simple example of what a basic
|
||||
`sed` command looks like:
|
||||
|
||||
[sed-wikipedia]: https://en.wikipedia.org/wiki/Sed
|
||||
|
||||
```console
|
||||
$ sed 's/hello/goodbye/'
|
||||
```
|
||||
|
||||
Discord likely implemented this in order to appeal to
|
||||
[IRC][irc-wikipedia][^irc-definition] users. Since IRC doesn't support editing
|
||||
messages, it's common for people to send messages in that format to tell people
|
||||
about changes to their previous message. Discord implemented this into both
|
||||
their web/desktop client and their iOS app, excluding the Android app.
|
||||
|
||||
[irc-wikipedia]: https://en.wikipedia.org/wiki/Internet_Relay_Chat
|
||||
|
||||
[^irc-definition]: IRC (Internet Relay Chat) is a simple text-based chat system.
|
||||
It's a very old protocol, however its simplicity and minimalism is the main
|
||||
reason people choose it. It's not very popular anymore.
|
||||
|
||||
Note that while real `sed` commands can get much more complicated, Discord's
|
||||
implementation doesn't support those advanced features[^trailing-slash-note].
|
||||
|
||||
[^trailing-slash-note]: Also note that in Discord's implementation, the trailing
|
||||
slash (after `goodbye`) can be ommitted (making it just `s/hello/goodbye`),
|
||||
but with the real `sed` command, it's required.
|
||||
|
||||
{{< see-also "/blog/text-substitution-in-discord-using-sed" >}}
|
||||
|
||||
## What does `s/e/x` do?
|
||||
|
||||
When you send a GIF using the GIF picker on Discord, it actually sends the link
|
||||
to the GIF, which is served by [Tenor][tenor-website]. For example, here's a GIF
|
||||
sent from Tenor:
|
||||
|
||||
[tenor-website]: https://tenor.com
|
||||
|
||||
https://tenor.com/view/cat-massage-gif-24282757
|
||||
|
||||
Running `s/e/x` will take the first occurrence of `e` and replace it with `x`.
|
||||
The link becomes the following (notice the bolded letter `x`):
|
||||
|
||||
[https://t**x**nor.com/view/cat-massage-gif-24282757][example-1]
|
||||
|
||||
[example-1]: https://txnor.com/view/cat-massage-gif-24282757
|
||||
|
||||
Then, all that's left to do is to buy the domain `txnor.com`, and write a simple
|
||||
program to run on it. In fact, it looks like that domain was purchased purely in
|
||||
order to make this trick possible[^txnor-domain-date].
|
||||
|
||||
[^txnor-domain-date]: According to [a quick WHOIS lookup][txnor-whois], the
|
||||
domain was registered on May 3, 2022. That's the same day that [@Rebane
|
||||
tweeted about the new feature][rebane-tweet] (~~going to https://txnor.com
|
||||
redirects to this tweet~~ now the domain redirects to [Rebane's YouTube video
|
||||
about the hack]({{< ref "#youtube-video" >}})), so I assume that this is the
|
||||
only reason they bought the domain.
|
||||
|
||||
[txnor-whois]: https://www.whois.com/whois/txnor.com
|
||||
[rebane-tweet]: https://twitter.com/rebane2001/status/1521544722875142145
|
||||
|
||||
## How does it display on Discord without redirecting?
|
||||
|
||||
When viewing any of the URLs on `txnor.com` in a normal web browser, you get
|
||||
[redirected to a tweet][rebane-tweet]. However, Discord is able to display the
|
||||
image without being redirected.
|
||||
|
||||
When Discord loads a website to generate an embed, it uses a user
|
||||
agent[^user-agent-definition] (which is a little piece of text which tells the
|
||||
server what your browser is) which looks something like this:
|
||||
|
||||
[^user-agent-definition]: If you actually care, there's a [Wikipedia
|
||||
article](https://en.wikipedia.org/wiki/User_agent), and a [page on
|
||||
WhatIsMyIPAddress.com](https://whatismyipaddress.com/user-agent) which also
|
||||
explain what a user agent is.
|
||||
|
||||
```text
|
||||
User-Agent: Mozilla/5.0 (compatible; Discordbot/2.0; +https://discordapp.com/)
|
||||
```
|
||||
|
||||
The important part here is the word `Discord`. If you visit the website with
|
||||
your user agent set to anything containing `Discord`
|
||||
(case-insensitive)[^discord-user-agent], then it serves the image directly.
|
||||
|
||||
[^discord-user-agent]: [According to the source code][user-agent-source-code],
|
||||
it looks like `Intel Mac OS X 11.6; rv:92.0` also triggers the same response.
|
||||
|
||||
[user-agent-source-code]: https://github.com/rebane2001/txnor-server/blob/26c7c279b0b4668c8a3b061692d83c507aeac7c5/txnor.nginx#L23-L27
|
||||
|
||||
## Default image
|
||||
|
||||
If you go to any URL on `txnor.com` that doesn't fit one of the existing
|
||||
patterns/games, then it returns this fallback image:
|
||||
|
||||
{{< figure src="default-sex" >}}
|
||||
|
||||
## Extra features
|
||||
|
||||
### Double sex
|
||||
|
||||
If you then run `s/e/x` a second time, then it changes to a different image:
|
||||
|
||||
{{< figure src="double-sex" >}}
|
||||
|
||||
This works in a simple way as well. The next `e` that appears in the URL is
|
||||
inside `/view/`. So, after typing `s/e/x` a second time, the URL becomes:
|
||||
|
||||
[https://txnor.com/vi**x**w/cat-massage-gif-24282757][example-2]
|
||||
|
||||
[example-2]: https://txnor.com/vixw/cat-massage-gif-24282757
|
||||
|
||||
### Chess (`s/w/ag`)
|
||||
|
||||
Another cool feature is that you can play chess by typing `s/w/ag` after typing
|
||||
the initial message of `s/e/x`.
|
||||
|
||||
{{< figure src="chess" >}}
|
||||
|
||||
### `s/w/ord`
|
||||
|
||||
If you do `s/w/ord` after `s/e/x`, then it starts a fighting game (titled
|
||||
"Wumpagotchi Adventures". You can use three commands: s/d/d**ATK**,
|
||||
s/d/d**DEF**, and s/d/d**HUG**.
|
||||
|
||||
Here are a few example images:
|
||||
|
||||
#### Main `s/w/ord` screen
|
||||
|
||||
{{< figure src="sword" >}}
|
||||
|
||||
#### ATK command
|
||||
|
||||
{{< figure src="sword-atk" >}}
|
||||
|
||||
#### DEF command
|
||||
|
||||
{{< figure src="sword-def" >}}
|
||||
|
||||
#### HUG command
|
||||
|
||||
{{< figure src="sword-hug" >}}
|
||||
|
||||
#### Win screen
|
||||
|
||||
{{< figure src="sword-win" >}}
|
||||
|
||||
#### Lose screen
|
||||
|
||||
{{< figure src="sword-lose" >}}
|
||||
|
||||
### 6969th Discord Sexer
|
||||
|
||||
If you happen to get a one in 6970 chance, it will instead return
|
||||
a special image:
|
||||
|
||||
{{< figure src="6969th" >}}
|
||||
|
||||
[6969th-source]: https://github.com/rebane2001/txnor-server/blob/26c7c279b0b4668c8a3b061692d83c507aeac7c5/sex.py#L130-L133
|
||||
|
||||
Here's a [snippet of the code that handles this chance][6969th-source]:
|
||||
|
||||
```python
|
||||
# 6969th winner image (disable for chess)
|
||||
if random.randint(0, 6969) == 6969 and "ag" not in name:
|
||||
web.header('Cache-Control', 'no-store')
|
||||
return six_nine
|
||||
```
|
||||
|
||||
I believe it's supposed to be a 1/6969 chance, but `random.randint` in Python
|
||||
[includes both numbers][randint-inclusive]. That means that the possible numbers that it could pick
|
||||
would be 0, 1, ... 6968, 6969. If you were to count the numbers included in that
|
||||
sequence, it would total 6970.
|
||||
|
||||
[randint-inclusive]: https://docs.python.org/3/library/random.html#random.randint
|
||||
|
||||
### Math challenge
|
||||
|
||||
Any URL that matches [this regular expression][math-challenge-regex] will
|
||||
instead return a randomized math challenge. This means the URL can be
|
||||
`https://txnor.com/` followed by either `math`, `math_challenge`, or
|
||||
`mathchallenge`, a single optional slash, and then any text that's made up of
|
||||
only letters, numbers, underscores or hyphens.
|
||||
|
||||
[math-challenge-regex]: https://regex101.com/r/ddEkML/1
|
||||
|
||||
{{< figure src="math-challenge" >}}
|
||||
|
||||
What's special is that the math challenge is [set to not be
|
||||
cached][math-challenge-caching]. That means that it
|
||||
*should*[^should-different-question] give everyone a different question.
|
||||
|
||||
[math-challenge-caching]: https://github.com/rebane2001/txnor-server/blob/26c7c279b0b4668c8a3b061692d83c507aeac7c5/sex.py#L137
|
||||
[^should-different-question]: The caching behavior seems to be inconsistent, so
|
||||
sometimes it does end up giving multiple people the same question.
|
||||
|
||||
How it works is that when each person's Discord client sends a request to the
|
||||
Discord CDN to get the image, the client caches that image. That means each
|
||||
client will see the same challenge problem, even if the user restarts the
|
||||
client. But separate clients will not have it cached, so they'll request it
|
||||
again themselves, and different numbers will be generated.
|
||||
|
||||
## Discord sex is open source
|
||||
|
||||
Thanks to a [comment from Rebane on this post](#isso-16), I now know that the
|
||||
server running on `txnor.com` is open source. See
|
||||
[rebane2001/txnor-server][txnor-server-github].
|
||||
|
||||
[txnor-server-github]: https://github.com/rebane2001/txnor-server
|
||||
|
||||
## YouTube video
|
||||
|
||||
Rebane also [made a YouTube video][txnor-youtube-video] about this trick. Make
|
||||
sure to check it out too!
|
||||
|
||||
[txnor-youtube-video]: https://www.youtube.com/watch?v=km8CR-fdB7o
|
BIN
content/blog/discord-sex-hack/math-challenge.webp
Normal file
After Width: | Height: | Size: 8.1 KiB |
BIN
content/blog/discord-sex-hack/sword-atk.webp
Normal file
After Width: | Height: | Size: 51 KiB |
BIN
content/blog/discord-sex-hack/sword-def.webp
Normal file
After Width: | Height: | Size: 48 KiB |
BIN
content/blog/discord-sex-hack/sword-hug.webp
Normal file
After Width: | Height: | Size: 50 KiB |
BIN
content/blog/discord-sex-hack/sword-lose.webp
Normal file
After Width: | Height: | Size: 34 KiB |
BIN
content/blog/discord-sex-hack/sword-win.webp
Normal file
After Width: | Height: | Size: 36 KiB |
BIN
content/blog/discord-sex-hack/sword.webp
Normal file
After Width: | Height: | Size: 47 KiB |
Before Width: | Height: | Size: 1.5 KiB After Width: | Height: | Size: 3.7 KiB |
@ -1,18 +1,19 @@
|
||||
---
|
||||
|
||||
title: Put `(edited)` in the middle of a message in Discord
|
||||
title: How to put `(edited)` in the middle of a message in Discord
|
||||
date: 2021-03-25T18:48:34-05:00
|
||||
lastmod: 2022-12-06T19:59:22-06:00
|
||||
toc: true
|
||||
comments: true
|
||||
|
||||
authors:
|
||||
- bbaovanc
|
||||
|
||||
aliases:
|
||||
- posts/edited-in-middle-of-message-discord/
|
||||
categories:
|
||||
- guides
|
||||
- tips-and-tricks
|
||||
|
||||
tags:
|
||||
- tutorial
|
||||
- discord
|
||||
- discord-tricks
|
||||
|
||||
@ -23,12 +24,19 @@ resources:
|
||||
|
||||
---
|
||||
|
||||
With a bit of trickery using the RLE character (U+202B), you can get the
|
||||
`(edited)` text on a message to be somewhere other than at the end of the
|
||||
message.
|
||||
You might have seen a trick on Discord where the little `(edited)` caption
|
||||
appears in the middle of a message instead of at the end. With a small hack
|
||||
involving the [right-to-left embedding character
|
||||
(U+202B)](https://unicode-explorer.com/c/202B), the `(edited)` text can be moved
|
||||
to any location inside the message.
|
||||
|
||||
<!--more-->
|
||||
|
||||
{{< aside note >}}
|
||||
This trick only works if you're on desktop/web, and will also only show to
|
||||
people on desktop/web.
|
||||
{{< /aside >}}
|
||||
|
||||
## Tutorial
|
||||
|
||||
Before you start, copy the "right-to-left embedding" character
|
||||
@ -36,24 +44,23 @@ Before you start, copy the "right-to-left embedding" character
|
||||
|
||||
### Method 1
|
||||
|
||||
This method allows you to create a placeholder message, and then replace it with
|
||||
a new message with the `(edited)` text inside it all at once.
|
||||
With this method you write a placeholder message, and then replace it completely
|
||||
with a new message containing the `(edited)` text inside it all at once.
|
||||
|
||||
1. Send a message with some random text since you have to edit an existing
|
||||
message for the trick to work.
|
||||
1. Send a message with some random text (this text will be replaced entirely)
|
||||
2. Start editing the message you just created and delete all the text inside
|
||||
3. Type the text you want on the left of `(edited)`.
|
||||
4. Type a space, then paste the character twice, and type another space.
|
||||
5. Type the text you want on the right of `(edited)`.
|
||||
6. Save the message.
|
||||
|
||||
You can also start at step 3 instead, send the message, and then edit the
|
||||
message afterwards to add the `(edited)` text.
|
||||
You can also start at step 3 instead, send the message, and then perform any
|
||||
edit on the message afterwards to add the `(edited)` text.
|
||||
|
||||
### Method 2
|
||||
|
||||
This method allows you to add `(edited)` to the end of an existing message, and
|
||||
then add even more text to the right of that.
|
||||
This method works by adding `(edited)` to the end of an existing message, and
|
||||
then extra text to the right.
|
||||
|
||||
1. Send a message containing the text you want on the left of `(edited)`.
|
||||
2. Start editing the message you just created
|
||||
|
@ -1,18 +1,23 @@
|
||||
---
|
||||
|
||||
title: GitHub Copilot experiments
|
||||
title: Experimenting with GitHub Copilot
|
||||
date: 2021-11-06T23:56:47-05:00
|
||||
lastmod: 2021-11-08T21:46:39-06:00
|
||||
toc: true
|
||||
comments: true
|
||||
|
||||
authors:
|
||||
- bbaovanc
|
||||
|
||||
categories:
|
||||
- experiments
|
||||
|
||||
tags:
|
||||
- github-copilot
|
||||
- programming
|
||||
|
||||
series:
|
||||
- GitHub Copilot Experiments
|
||||
- github-copilot-experiments
|
||||
|
||||
resources:
|
||||
- name: feature
|
||||
|
251
content/blog/swapfile-guide/index.md
Normal file
@ -0,0 +1,251 @@
|
||||
---
|
||||
|
||||
title: How to create (or remove) a swapfile on Linux
|
||||
date: 2023-04-04T17:26:44-05:00
|
||||
lastmod: 2023-04-04T17:26:44-05:00
|
||||
toc: true
|
||||
comments: true
|
||||
|
||||
authors:
|
||||
- bbaovanc
|
||||
|
||||
categories:
|
||||
- guides
|
||||
- tips-and-tricks
|
||||
|
||||
tags:
|
||||
- linux
|
||||
- linux-swap
|
||||
- swapfile
|
||||
|
||||
---
|
||||
|
||||
A step-by-step tutorial on how to create or remove a swapfile on a Linux
|
||||
machine, and how to decide if you need one.
|
||||
|
||||
<!--more-->
|
||||
|
||||
## Should you use swap?
|
||||
|
||||
A common misconception is that adding swap to your system can reduce
|
||||
performance. However, even if you aren't running out of RAM, it can still be
|
||||
beneficial to add swap.
|
||||
|
||||
See these points according to [an article by Hayden James][always-add-swap]:
|
||||
|
||||
> - Even if there is still available RAM, the Linux Kernel will **move memory
|
||||
> pages that are hardly ever used** into swap space.
|
||||
>
|
||||
> - It’s better to swap out memory pages that have been inactive for a while,
|
||||
> **keeping often-used data in cache**, and this should happen when the server
|
||||
> is most idle, which is the aim of the Kernel.
|
||||
>
|
||||
> - Avoid setting your swap space too large if it will result in prolonging
|
||||
> performance issues, outages, or your response time (without proper
|
||||
> monitoring/alerts).
|
||||
|
||||
[always-add-swap]: https://haydenjames.io/linux-performance-almost-always-add-swap-space/
|
||||
|
||||
### Should you use a swap file or partition?
|
||||
|
||||
Swap partitions should be preferred because swapfiles tend to be slower and
|
||||
slightly more complex to set up, especially if hibernating. A swapfile might be
|
||||
preferred due to its flexibility (ease to resize), but if you use
|
||||
[LVM][lvm-archwiki] then you can easily resize the swap partition anyways.
|
||||
|
||||
[lvm-archwiki]: https://wiki.archlinux.org/title/LVM
|
||||
|
||||
## Tutorial
|
||||
|
||||
{{% include "snippets/console.md" %}}
|
||||
|
||||
### Step 1: Create the file
|
||||
|
||||
The first step is to allocate the file.
|
||||
|
||||
```console
|
||||
# dd if=/dev/zero of=/swapfile bs=1M count=[size in MiB] status=progress
|
||||
```
|
||||
|
||||
Replace `[size in MiB]` with the size of your swapfile in Mebibytes (MiB). You
|
||||
can use [this online converter](https://www.convertunits.com/from/GiB/to/MiB) to
|
||||
convert from Gibibytes (GiB, often confused with Gigabytes, but that's a
|
||||
misconception for another time) to MiB, which you can put in the command.
|
||||
|
||||
Or you can look at this table for common sizes:
|
||||
|
||||
| GiB | MiB |
|
||||
|-----|-------------|
|
||||
| 1 | count=1024 |
|
||||
| 2 | count=2048 |
|
||||
| 3 | count=3072 |
|
||||
| 4 | count=4096 |
|
||||
| 8 | count=8192 |
|
||||
| 16 | count=16384 |
|
||||
{.simple}
|
||||
|
||||
If you aren't sure how big your swapfile should be, take a look at [Table 15.1
|
||||
on this Red Hat documentation page][redhat-swap-table]. Remember that if your
|
||||
first swapfile isn't large enough, you can create another one.
|
||||
|
||||
[redhat-swap-table]: https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/7/html/storage_administration_guide/ch-swapspace#tb-recommended-system-swap-space
|
||||
|
||||
On my computer I have 32 GiB of RAM and a 16 GiB swap partition, rather than
|
||||
swapfile, because I can flexibly expand the swap partition using
|
||||
[LVM][lvm-archwiki].
|
||||
|
||||
{{< aside example >}}
|
||||
|
||||
To create a swapfile 4 GiB in size, you would run:
|
||||
|
||||
```console
|
||||
# dd if=/dev/zero of=/swapfile bs=1M count=4096 status=progress
|
||||
4096+0 records in
|
||||
4096+0 records out
|
||||
4294967296 bytes (4.3 GB, 4.0 GiB) copied, 0.960183 s, 4.5 GB/s
|
||||
```
|
||||
|
||||
{{< /aside >}}
|
||||
|
||||
### Step 2: Change swapfile permissions
|
||||
|
||||
The swapfile should only be readable by the system (`root` user). Run this
|
||||
command to change it:
|
||||
|
||||
```console
|
||||
# chmod 600 /swapfile
|
||||
```
|
||||
|
||||
### Step 3: Format the swapfile
|
||||
|
||||
Use the `mkswap` command to format the file to be used as swap (basically just
|
||||
add a header to identify it):
|
||||
|
||||
```console
|
||||
# mkswap /swapfile
|
||||
Setting up swapspace version 1, size = 4 GiB (4294963200 bytes)
|
||||
no label, UUID=a0b87eca-b951-4344-be2d-020d77cdef48
|
||||
```
|
||||
|
||||
### Step 4: Create an entry in `/etc/fstab`
|
||||
|
||||
An entry needs to be added to `/etc/fstab` for the swapfile to be enabled during
|
||||
bootup. Open `/etc/fstab` in a text editor, and add this line to the end (add
|
||||
spaces to line up with other entries if you want, whitespace is ignored):
|
||||
|
||||
```text
|
||||
/swapfile none swap sw 0 0
|
||||
```
|
||||
|
||||
{{< aside note >}}
|
||||
|
||||
Above, I have filled the "options" field with `sw`. Some guides suggest using
|
||||
either `sw` or `defaults`. Neither of those options is valid for `swapon` and
|
||||
they are both ignored. However, the field does need to be filled out with
|
||||
something, so feel free to put something funny (do let me know in the comments
|
||||
if this somehow breaks something though).
|
||||
|
||||
If you're curious, this is my `fstab` entry (`UUID` is because I use a swap
|
||||
partition, rather than swapfile):
|
||||
|
||||
```text
|
||||
# /dev/mapper/bobavg0-swap
|
||||
UUID=4f7c3ae8-839b-4474-b8a5-96bd78db06f8 none swap bobaswap 0 0
|
||||
```
|
||||
|
||||
{{< /aside >}}
|
||||
|
||||
### Step 5: Enable the swapfile
|
||||
|
||||
Adding the `fstab` entry won't enable the swapfile until a reboot. To enable it
|
||||
now, use the `swapon` command.
|
||||
|
||||
```console
|
||||
# swapon /swapfile
|
||||
```
|
||||
|
||||
### Finally: check the swap status
|
||||
|
||||
Use `swapon` and `free` to verify that your new swapfile has been added:
|
||||
|
||||
```console
|
||||
$ swapon --show
|
||||
NAME TYPE SIZE USED PRIO
|
||||
/swapfile file 4G 0B -2
|
||||
|
||||
$ free -h
|
||||
total used free shared buff/cache available
|
||||
Mem: 31Gi 3.6Gi 20Gi 233Mi 6.9Gi 26Gi
|
||||
Swap: 4.0Gi 0B 4.0Gi
|
||||
```
|
||||
|
||||
{{< aside note >}}
|
||||
|
||||
If you get an error saying that the `swapon` command was not found, try running
|
||||
it as `root` (using `sudo`). On Debian-based distributions the `swapon` command
|
||||
is not available to regular users.
|
||||
|
||||
```console
|
||||
$ swapon --show
|
||||
bash: swapon: command not found
|
||||
|
||||
# swapon --show
|
||||
NAME TYPE SIZE USED PRIO
|
||||
/swapfile file 4G 0B -2
|
||||
```
|
||||
|
||||
{{< /aside >}}
|
||||
|
||||
## Removing a swapfile
|
||||
|
||||
{{< aside warning >}}
|
||||
|
||||
Be careful that the swapfile isn't being highly used because once you run
|
||||
`swapoff`, it will dump the entire contents back into RAM and may cause you to
|
||||
run out of memory.
|
||||
|
||||
{{< /aside >}}
|
||||
|
||||
### Step 1: Disable/unload the swapfile
|
||||
|
||||
```console
|
||||
$ swapon --show
|
||||
NAME TYPE SIZE USED PRIO
|
||||
/swapfile file 4G 0B -2
|
||||
|
||||
$ # the path to the swapfile I want to remove is `/swapfile`
|
||||
|
||||
# swapoff /swapfile
|
||||
```
|
||||
|
||||
### Step 2: Remove the entry from `fstab`
|
||||
|
||||
Open `/etc/fstab` in a text editor and find the line matching the swapfile you
|
||||
want to remove, and delete it. For example:
|
||||
|
||||
```text
|
||||
/swapfile none swap sw 0 0
|
||||
```
|
||||
|
||||
### Step 3: Delete the actual file
|
||||
|
||||
```console
|
||||
# rm /swapfile
|
||||
```
|
||||
|
||||
## References
|
||||
|
||||
### Use `dd` instead of `fallocate`
|
||||
|
||||
See ["Files with holes" under the man page][swapon-holes-man].
|
||||
|
||||
[swapon-holes-man]: https://man.archlinux.org/man/core/util-linux/swapon.8.en#Files_with_holes
|
||||
|
||||
### The options field in fstab
|
||||
|
||||
On Linux, `sw` doesn't mean anything for `swapon`, so it gets ignored. See:
|
||||
|
||||
- [StackExchange answer 1](https://unix.stackexchange.com/a/365961/525130)
|
||||
- [StackExchange answer 2](https://unix.stackexchange.com/a/365954/525130)
|
||||
- [`parse_options` in the `swapon` source code](https://github.com/util-linux/util-linux/blob/2ea397239683270a0fc8cd3b72ed5457f52dbda8/sys-utils/swapon.c#L699)
|
||||
- [options set by fstab `defaults` (none have any effect on `swapon`)](https://man.archlinux.org/man/fstab.5#The_fourth_field_(%3Ci%3Efs_mntops%3C/i%3E).)
|
@ -2,20 +2,20 @@
|
||||
|
||||
title: Text substitution in Discord using `sed`
|
||||
date: 2021-03-25T18:48:15-05:00
|
||||
lastmod: 2021-10-19T14:02:08-05:00
|
||||
toc: false
|
||||
comments: true
|
||||
|
||||
authors:
|
||||
- bbaovanc
|
||||
|
||||
aliases:
|
||||
- /blog/posts/sed-text-substitution-in-discord/
|
||||
- /blog/posts/text-substitution-in-discord-using-sed/
|
||||
categories:
|
||||
- tips-and-tricks
|
||||
|
||||
tags:
|
||||
- tutorial
|
||||
- discord
|
||||
- discord-tricks
|
||||
- sed
|
||||
|
||||
resources:
|
||||
- name: feature
|
||||
|
@ -2,17 +2,20 @@
|
||||
|
||||
title: The redesign of my website
|
||||
date: 2021-10-18T14:03:05-05:00
|
||||
lastmod: 2021-10-27T09:51:43-05:00
|
||||
toc: true
|
||||
comments: true
|
||||
|
||||
authors:
|
||||
- bbaovanc
|
||||
|
||||
categories:
|
||||
- meta
|
||||
|
||||
tags:
|
||||
- announcement
|
||||
- blog
|
||||
- hugo
|
||||
- bobatheme
|
||||
- hugo
|
||||
- web-development
|
||||
|
||||
resources:
|
||||
- name: feature
|
||||
|
@ -2,18 +2,21 @@
|
||||
|
||||
title: Using Github Copilot to write a blog post
|
||||
date: 2021-11-07T16:17:15-06:00
|
||||
lastmod: 2021-11-08T21:46:39-06:00
|
||||
toc: true
|
||||
comments: true
|
||||
|
||||
authors:
|
||||
- bbaovanc
|
||||
|
||||
categories:
|
||||
|
||||
tags:
|
||||
- github-copilot
|
||||
- blog
|
||||
- markdown
|
||||
|
||||
series:
|
||||
- GitHub Copilot Experiments
|
||||
- github-copilot-experiments
|
||||
|
||||
# this will be shown for the article in list pages and in the page metadata
|
||||
# it can be either an image or video (this might change in the future, however)
|
||||
@ -60,4 +63,4 @@ word or two, and Copilot turned it into a couple sentences.
|
||||
|
||||
## The finished product
|
||||
|
||||
The actual blog post written by Copilot is available [here]({{< ref "../copilot-post/" >}}).
|
||||
The actual blog post written by Copilot is available [here]({{< ref "/blog/copilot-post/" >}}).
|
||||
|
@ -2,15 +2,19 @@
|
||||
|
||||
title: Youtube URL structures you should know
|
||||
date: 2021-10-30T21:20:38-05:00
|
||||
lastmod: 2023-01-16T21:04:09-06:00
|
||||
toc: true
|
||||
comments: true
|
||||
|
||||
authors:
|
||||
- bbaovanc
|
||||
|
||||
categories:
|
||||
- tips-and-tricks
|
||||
|
||||
tags:
|
||||
- youtube
|
||||
- url-structures
|
||||
- youtube
|
||||
|
||||
resources:
|
||||
- name: feature
|
||||
@ -23,7 +27,7 @@ resources:
|
||||
[What is a
|
||||
URL?](https://developer.mozilla.org/en-US/docs/Learn/Common_questions/What_is_a_URL#parameters)
|
||||
by [Mozilla
|
||||
Contributors](https://developer.mozilla.org/en-US/docs/MDN/About/contributors.txt)
|
||||
Contributors](https://developer.mozilla.org/en-US/docs/Learn/Common_questions/Web_mechanics/What_is_a_URL/contributors.txt)
|
||||
is licensed under [CC-BY-SA
|
||||
2.5](https://creativecommons.org/licenses/by-sa/2.5/)
|
||||
|
||||
@ -60,7 +64,7 @@ Here's the video I'll be using as an example:
|
||||
|
||||
{{< youtube F6va6tg62qg >}}
|
||||
|
||||
I embedded that video on my website with this code:[^1]
|
||||
I embedded that video on my website with this code:[^hugo-shortcode]
|
||||
|
||||
```text
|
||||
{{</* youtube F6va6tg62qg */>}}
|
||||
@ -121,5 +125,9 @@ As far as I know, it's not possible to link to a playlist using `youtu.be`.
|
||||
[This Stack Exchange answer](https://webapps.stackexchange.com/a/9881) is a good
|
||||
reference for some other YouTube parameters.
|
||||
|
||||
[^1]: I use a static site generator called [Hugo](https://gohugo.io) for my
|
||||
website.
|
||||
[^hugo-shortcode]: I use a static site generator called
|
||||
[Hugo](https://gohugo.io) for my website. It has a built in "shortcode" which
|
||||
is a feature that allows me to embed certain code blocks into a page. One of
|
||||
its shortcodes, named `youtube`, allows me to embed a YouTube video into my
|
||||
post. You can read more info about [shortcodes on the Hugo
|
||||
docs](https://gohugo.io/content-management/shortcodes/#use-hugos-built-in-shortcodes)
|
||||
|
7
content/categories/_index.md
Normal file
@ -0,0 +1,7 @@
|
||||
---
|
||||
|
||||
title: Categories
|
||||
|
||||
---
|
||||
|
||||
Categories are the different types or styles of posts.
|
10
content/categories/experiments/_index.md
Normal file
@ -0,0 +1,10 @@
|
||||
---
|
||||
|
||||
title: Experiments
|
||||
|
||||
---
|
||||
|
||||
These posts are less planned and instead focus around exploring something to
|
||||
understand it better.
|
||||
|
||||
<!--more-->
|
9
content/categories/guides/_index.md
Normal file
@ -0,0 +1,9 @@
|
||||
---
|
||||
|
||||
title: Guides
|
||||
|
||||
---
|
||||
|
||||
Any kind of guide or tutorial.
|
||||
|
||||
<!--more-->
|
9
content/categories/meta/_index.md
Normal file
@ -0,0 +1,9 @@
|
||||
---
|
||||
|
||||
title: Meta
|
||||
|
||||
---
|
||||
|
||||
Posts talking about my website.
|
||||
|
||||
<!--more-->
|
9
content/categories/reviews/_index.md
Normal file
@ -0,0 +1,9 @@
|
||||
---
|
||||
|
||||
title: Reviews
|
||||
|
||||
---
|
||||
|
||||
Posts that review stuff.
|
||||
|
||||
<!--more-->
|
10
content/categories/tips-and-tricks/_index.md
Normal file
@ -0,0 +1,10 @@
|
||||
---
|
||||
|
||||
title: Tips and Tricks
|
||||
|
||||
---
|
||||
|
||||
Random little tips and/or tricks that I want to share. Will probably be mostly
|
||||
short articles (but that's not a bad thing).
|
||||
|
||||
<!--more-->
|
@ -1,17 +0,0 @@
|
||||
---
|
||||
|
||||
title: Contact
|
||||
menu: main
|
||||
toc: false
|
||||
comments: false
|
||||
|
||||
authors:
|
||||
- bbaovanc
|
||||
|
||||
description: >-
|
||||
Want to contact me? Here's how you can.
|
||||
|
||||
---
|
||||
|
||||
- Email: [contact@bbaovanc.com](mailto:contact@bbaovanc.com)
|
||||
- Matrix: [@bbaovanc:boba.best](https://matrix.to/#/@bbaovanc:boba.best)
|
@ -1,25 +0,0 @@
|
||||
---
|
||||
|
||||
title: Donate
|
||||
menu: main
|
||||
toc: false
|
||||
comments: false
|
||||
|
||||
authors:
|
||||
- bbaovanc
|
||||
|
||||
description: >-
|
||||
I have a few cryptocurrency addresses that you can use if you want to donate
|
||||
to me.
|
||||
|
||||
---
|
||||
|
||||
## Cryptocurrency Addresses
|
||||
|
||||
Nano: `nano_1ewtme68x5gia1bjq3jx1ku5pcxzayipdxjmjrc3x8qjjpat4ria8ajhjoxd`
|
||||
|
||||
Bitcoin: `bc1qj6h8z2tg9nxcl9ddnv9k798cru6asr6cpmj84m`
|
||||
|
||||
Ethereum: `0x80DaED7e2BEF5d894b37fBd79d0609aa17c8Cabc`
|
||||
|
||||
Monero: `45gGauNcWLNSobRMzk3rtfEpad7gGcEvegxCbEm6QYENdG4vag3fCVuFoKfdKSESeSEKyUNRGwAJyLaCQ6MC5AQ79DGcaRq`
|
@ -3,56 +3,87 @@
|
||||
title: Links
|
||||
menu: main
|
||||
toc: true
|
||||
comments: false
|
||||
comments: true
|
||||
|
||||
authors:
|
||||
- bbaovanc
|
||||
|
||||
aliases:
|
||||
- /blog/links/
|
||||
|
||||
description: >-
|
||||
A page with links to a lot of my different projects.
|
||||
|
||||
---
|
||||
|
||||
## Other
|
||||
## Profiles
|
||||
|
||||
- [GitHub](https://github.com/BBaoVanC/)
|
||||
- [boba.best](https://boba.best/)
|
||||
- [GitHub](https://github.com/BBaoVanC/) - my GitHub account
|
||||
|
||||
## My Website
|
||||
|
||||
- [Homepage](https://bbaovanc.com/) - theme:
|
||||
[bobatheme](https://github.com/BBaoVanC/bobatheme)
|
||||
- [Blog](https://bbaovanc.com/blog/)
|
||||
- [Status Page](https://status.bbaovanc.com/)
|
||||
- [Searx Instance](https://search.bbaovanc.com/) -
|
||||
[source code](https://github.com/BBaoVanC/searx)
|
||||
- [Gitea Instance](https://git.bbaovanc.com/)
|
||||
- [bbaovanc.com source code](https://github.com/BBaoVanC/bbaovanc.com)
|
||||
- [bobatheme](https://github.com/BBaoVanC/bobatheme) - theme for this website
|
||||
- [demo.bbaovanc.com](https://demo.bbaovanc.com) - previews of pull requests to my website
|
||||
|
||||
## My Software
|
||||
Also see [Isso](https://github.com/posativ/isso), which is currently the comment
|
||||
system I use on my website.
|
||||
|
||||
- [smines](https://github.com/BBaoVanC/smines)
|
||||
- [imgupload.py](https://github.com/imgupload-py/imgupload.py)
|
||||
- [mojiman](https://github.com/BBaoVanC/mojiman)
|
||||
- [pynamegen](https://git.bbaovanc.com/bbaovanc/pynamegen)
|
||||
### Other Websites
|
||||
|
||||
- [git.bbaovanc.com](https://git.bbaovanc.com) - mostly just mirrors of my GitHub repos
|
||||
- [plausible.bbaovanc.com](https://plausible.bbaovanc.com/bbaovanc.com) -
|
||||
anonymous analytics on my website
|
||||
- [share.boba.best](https://share.boba.best) - temporary file uploader
|
||||
- [status.bbaovanc.com](https://status.bbaovanc.com) - my status page
|
||||
|
||||
## My Projects
|
||||
|
||||
- [bobashare](https://github.com/BBaoVanC/bobashare) - simple file sharing
|
||||
server, runs https://share.boba.best
|
||||
- [bobascheme](https://github.com/BBaoVanC/bobascheme) - theme I use on my
|
||||
terminal and editors
|
||||
- [smines](https://github.com/BBaoVanC/smines) - terminal-based minesweeper in C
|
||||
- [imgupload.py](https://github.com/imgupload-py/imgupload.py) - simple image
|
||||
uploading server written with Python Flask
|
||||
- [pynamegen](https://git.bbaovanc.com/bbaovanc/pynamegen) - name generator
|
||||
written in Python
|
||||
- [libnamegen](https://git.bbaovanc.com/bbaovanc/libnamegen)
|
||||
- [liblistloader](https://git.bbaovanc.com/bbaovanc/liblistloader)
|
||||
- [libprogress](https://git.bbaovanc.com/bbaovanc/libprogress)
|
||||
- [RokuRemote](https://github.com/BBaoVanC/RokuRemote)
|
||||
- [RokuRemote](https://github.com/BBaoVanC/RokuRemote) - keyboard-based remote
|
||||
control for Roku
|
||||
|
||||
### Minecraft Plugins
|
||||
|
||||
- [bobawhitelist](https://github.com/BBaoVanC/bobawhitelist) - global whitelist
|
||||
plugin for the [Velocity](https://github.com/PaperMC/Velocity) proxy
|
||||
- [GlobalJoinLeave](https://github.com/bobacraft/GlobalJoinLeave) - global
|
||||
join/leave messages on Velocity
|
||||
- [velocitab](https://github.com/BBaoVanC/velocitab) - global tab list plugin
|
||||
for Velocity
|
||||
- [velocity-chat](https://github.com/BBaoVanC/velocity-chat) - global chat
|
||||
plugin for Velocity
|
||||
|
||||
## My Configurations
|
||||
|
||||
- [dotfiles](https://github.com/BBaoVanC/dotfiles)
|
||||
- [dwm](https://github.com/BBaoVanC/.dwm)
|
||||
- [dwm-flexipatch](https://github.com/BBaoVanC/dwm-flexipatch)
|
||||
- [dwmblocks](https://github.com/BBaoVanC/dwmblocks)
|
||||
- [dmenu](https://github.com/BBaoVanC/dmenu)
|
||||
- [dotfiles](https://github.com/BBaoVanC/dotfiles) - main repository with my
|
||||
configs
|
||||
- [docker-dotfiles](https://github.com/BBaoVanC/docker-dotfiles) - Docker image
|
||||
that contains my dotfiles
|
||||
|
||||
### Archived
|
||||
### Historical configurations
|
||||
|
||||
- [dwm](https://github.com/BBaoVanC/dwm)
|
||||
- [st](https://github.com/BBaoVanC/st)
|
||||
- [slstatus](https://github.com/BBaoVanC/slstatus)
|
||||
- [xmonad](https://github.com/BBaoVanC/.xmonad)
|
||||
- [dwm](https://github.com/BBaoVanC/.dwm) - outer repo with submodules for my
|
||||
various dwm-related configs
|
||||
- [dwm-flexipatch](https://github.com/BBaoVanC/dwm-flexipatch) - see
|
||||
https://github.com/bakkeby/dwm-flexipatch
|
||||
- [dwmblocks](https://github.com/BBaoVanC/dwmblocks) - DWM status bar, see
|
||||
https://github.com/torrinfail/dwmblocks
|
||||
- [dmenu](https://github.com/BBaoVanC/dmenu) - dynamic menu, see
|
||||
https://tools.suckless.org/dmenu/
|
||||
- [st](https://github.com/BBaoVanC/st) - simple terminal, see
|
||||
https://st.suckless.org
|
||||
- [slstatus](https://github.com/BBaoVanC/slstatus) - suckless status, see
|
||||
https://tools.suckless.org/slstatus/
|
||||
- [dwm](https://github.com/BBaoVanC/dwm) - dynamic window manager, see
|
||||
https://dwm.suckless.org/
|
||||
- [onehalf](https://github.com/BBaoVanC/onehalf) - nice theme that I used to use
|
||||
- [xmonad](https://github.com/BBaoVanC/.xmonad) - see https://xmonad.org
|
||||
|
12
content/search/index.md
Normal file
@ -0,0 +1,12 @@
|
||||
---
|
||||
|
||||
title: Search
|
||||
layout: search
|
||||
menus:
|
||||
main:
|
||||
name: Search
|
||||
|
||||
---
|
||||
|
||||
Quickly search the full text of any article on my website! Powered by
|
||||
[Pagefind](https://pagefind.app/).
|
7
content/series/_index.md
Normal file
@ -0,0 +1,7 @@
|
||||
---
|
||||
|
||||
title: Series
|
||||
|
||||
---
|
||||
|
||||
Series are groups of closely related posts, often with some ordering to them.
|
@ -2,8 +2,9 @@
|
||||
|
||||
title: Github Copilot Experiments
|
||||
|
||||
description: >-
|
||||
Make sure to read the last two posts where I made GitHub Copilot write a blog
|
||||
post itself.
|
||||
|
||||
---
|
||||
|
||||
Make sure to read the last two posts where I made GitHub Copilot write a blog
|
||||
post itself.
|
||||
|
||||
<!--more-->
|
||||
|
8
content/snippets/_index.md
Normal file
@ -0,0 +1,8 @@
|
||||
---
|
||||
title: Snippets
|
||||
cascade:
|
||||
build:
|
||||
list: never
|
||||
publishResources: false
|
||||
render: never
|
||||
---
|
36
content/snippets/console.md
Normal file
@ -0,0 +1,36 @@
|
||||
---
|
||||
title: Console command prefix formatting explanation
|
||||
---
|
||||
|
||||
{{< aside info >}}
|
||||
|
||||
Commands in this article are prefixed them with a prompt symbol (either `$` or
|
||||
`#`) which is not part of the command. Lines with no prompt symbol are output
|
||||
from the command.
|
||||
|
||||
The `#` means to run it as `root` (usually using `sudo`):
|
||||
|
||||
```console
|
||||
$ ls /var/lib/docker
|
||||
ls: cannot open directory '/var/lib/docker': Permission denied
|
||||
|
||||
$ # this is a comment
|
||||
$ # regular users aren't allowed to view /var/lib/docker, we need root
|
||||
|
||||
# ls /var/lib/docker
|
||||
builder containerd image overlay2 runtimes tmp volumes
|
||||
buildkit containers network plugins swarm trust
|
||||
|
||||
$ # we can do the same thing using sudo
|
||||
|
||||
$ sudo ls /var/lib/docker
|
||||
[sudo] password for bbaovanc:
|
||||
builder containerd image overlay2 runtimes tmp volumes
|
||||
buildkit containers network plugins swarm trust
|
||||
```
|
||||
|
||||
If you want to copy just the commands (for example: pasting them into your own
|
||||
terminal to run them all), press the [Copy](javascript:void(0)) button in the top right of the code
|
||||
block.
|
||||
|
||||
{{< /aside >}}
|
7
content/tags/_index.md
Normal file
@ -0,0 +1,7 @@
|
||||
---
|
||||
|
||||
title: Tags
|
||||
|
||||
---
|
||||
|
||||
Tags are the specific topics that a post deals with.
|
12
content/tags/bobatheme/_index.md
Normal file
@ -0,0 +1,12 @@
|
||||
---
|
||||
|
||||
title: bobatheme
|
||||
|
||||
---
|
||||
|
||||
Posts about bobatheme, my custom [Hugo][hugo-website] theme which I use on this
|
||||
website.
|
||||
|
||||
[hugo-website]: https://gohugo.io
|
||||
|
||||
<!--more-->
|
14
content/tags/caddy/_index.md
Normal file
@ -0,0 +1,14 @@
|
||||
---
|
||||
|
||||
title: Caddy
|
||||
|
||||
---
|
||||
|
||||
Caddy is a powerful and open source webserver written in [Golang][golang] which
|
||||
includes some fancy features such as built-in automatic HTTPS. It's by far my
|
||||
favorite webserver. See my [blog post about Caddy][caddy-blog-post] for why.
|
||||
|
||||
[golang]: https://go.dev/
|
||||
[caddy-blog-post]: {{< ref "/blog/caddy-is-the-best-webserver" >}}
|
||||
|
||||
<!--more-->
|
11
content/tags/devops/_index.md
Normal file
@ -0,0 +1,11 @@
|
||||
---
|
||||
|
||||
title: DevOps
|
||||
|
||||
---
|
||||
|
||||
Posts about toolchain and software pipeline stuff. The abbreviation means
|
||||
software development (Dev) plus IT operations (Ops). Includes things such as
|
||||
CI/CD (GitHub Actions).
|
||||
|
||||
<!--more-->
|
9
content/tags/discord-tricks/_index.md
Normal file
@ -0,0 +1,9 @@
|
||||
---
|
||||
|
||||
title: Discord Tricks
|
||||
|
||||
---
|
||||
|
||||
Tips and tricks I have learned about Discord.
|
||||
|
||||
<!--more-->
|
14
content/tags/discord/_index.md
Normal file
@ -0,0 +1,14 @@
|
||||
---
|
||||
|
||||
title: Discord
|
||||
|
||||
---
|
||||
|
||||
An extremely popular chat platform. You have to live under a rock to not know
|
||||
what Discord is.
|
||||
|
||||
<!--more-->
|
||||
|
||||
See also: the [discord-tricks tag][discord-tricks-tag].
|
||||
|
||||
[discord-tricks-tag]: {{< ref "/tags/discord-tricks/" >}}
|
11
content/tags/github-actions/_index.md
Normal file
@ -0,0 +1,11 @@
|
||||
---
|
||||
|
||||
title: Github Actions
|
||||
|
||||
---
|
||||
|
||||
Any posts that talk about GitHub's CI/CD platform. This is what I use for
|
||||
automatic tasks on my website, such as automatic audits, and automatic building
|
||||
and deploying.
|
||||
|
||||
<!--more-->
|
14
content/tags/github-copilot/_index.md
Normal file
@ -0,0 +1,14 @@
|
||||
---
|
||||
|
||||
title: GitHub Copilot
|
||||
|
||||
---
|
||||
|
||||
An extension made by GitHub which provides artificial intelligence powered
|
||||
autocomplete, trained on real open source code. It is intended to give smarter
|
||||
results than a typical autocomplete solution can, such as automatically
|
||||
generating [boilerplate code][boilerplate-code].
|
||||
|
||||
[boilerplate-code]: https://en.wikipedia.org/wiki/Boilerplate_code
|
||||
|
||||
<!--more-->
|
11
content/tags/google-lighthouse/_index.md
Normal file
@ -0,0 +1,11 @@
|
||||
---
|
||||
|
||||
title: Google Lighthouse
|
||||
|
||||
---
|
||||
|
||||
Lighthouse is a tool that can audit websites based on performance,
|
||||
accessibility, SEO, and more. It also provides useful suggestions on how a
|
||||
website can be improved.
|
||||
|
||||
<!--more-->
|
9
content/tags/hugo/_index.md
Normal file
@ -0,0 +1,9 @@
|
||||
---
|
||||
|
||||
title: Hugo
|
||||
|
||||
---
|
||||
|
||||
Hugo is a static site generator which I use to generate this website.
|
||||
|
||||
<!--more-->
|
13
content/tags/linux-swap/_index.md
Normal file
@ -0,0 +1,13 @@
|
||||
---
|
||||
|
||||
title: Swap (Linux)
|
||||
|
||||
---
|
||||
|
||||
Swap space is storage on your drive that can be used as virtual memory when the
|
||||
system is running low on physical memory (RAM). It is also used when hibernating
|
||||
(suspend to disk).
|
||||
|
||||
<!--more-->
|
||||
|
||||
More information: https://haydenjames.io/linux-performance-almost-always-add-swap-space/
|
9
content/tags/linux/_index.md
Normal file
@ -0,0 +1,9 @@
|
||||
---
|
||||
|
||||
title: Linux
|
||||
|
||||
---
|
||||
|
||||
Anything relating to Linux (the kernel or operating systems).
|
||||
|
||||
<!--more-->
|
11
content/tags/markdown/_index.md
Normal file
@ -0,0 +1,11 @@
|
||||
---
|
||||
|
||||
title: Markdown
|
||||
|
||||
---
|
||||
|
||||
Markdown is a simple and easy to use markup language which is actually used to
|
||||
write the content on this website. Writing it only requires learning a very
|
||||
basis syntax, and using a plain-text editor.
|
||||
|
||||
<!--more-->
|
9
content/tags/programming/_index.md
Normal file
@ -0,0 +1,9 @@
|
||||
---
|
||||
|
||||
title: Programming
|
||||
|
||||
---
|
||||
|
||||
Any posts relating to programming and/or software development.
|
||||
|
||||
<!--more-->
|
11
content/tags/sed/_index.md
Normal file
@ -0,0 +1,11 @@
|
||||
---
|
||||
|
||||
title: sed
|
||||
|
||||
---
|
||||
|
||||
Short for "stream editor", `sed` is a utility used to edit text on Unix systems.
|
||||
It is usually used with regular expressions (regex for short). If you're
|
||||
interested, look up "regex basics" and "sed basics", or something similar.
|
||||
|
||||
<!--more-->
|
11
content/tags/swapfile/_index.md
Normal file
@ -0,0 +1,11 @@
|
||||
---
|
||||
|
||||
title: swapfile
|
||||
|
||||
---
|
||||
|
||||
A swapfile is a file that gives your system more [swap]({{< relref
|
||||
"../linux-swap" >}}) space, which is used when the system is running low on RAM,
|
||||
or when hibernating.
|
||||
|
||||
<!--more-->
|
10
content/tags/sysadmin/_index.md
Normal file
@ -0,0 +1,10 @@
|
||||
---
|
||||
|
||||
title: Sysadmin
|
||||
|
||||
---
|
||||
|
||||
Anything relating to managing servers (usually relating to Linux). "Sysadmin" is
|
||||
short for "system administrator".
|
||||
|
||||
<!--more-->
|
10
content/tags/systemd/_index.md
Normal file
@ -0,0 +1,10 @@
|
||||
---
|
||||
|
||||
title: systemd
|
||||
|
||||
---
|
||||
|
||||
`systemd` is by far the most popular service manager (known as an "init system")
|
||||
used on Linux.
|
||||
|
||||
<!--more-->
|
9
content/tags/url-structures/_index.md
Normal file
@ -0,0 +1,9 @@
|
||||
---
|
||||
|
||||
title: URL Structures
|
||||
|
||||
---
|
||||
|
||||
Posts about URL conventions on certain websites or services.
|
||||
|
||||
<!--more-->
|
9
content/tags/web-development/_index.md
Normal file
@ -0,0 +1,9 @@
|
||||
---
|
||||
|
||||
title: Web Development
|
||||
|
||||
---
|
||||
|
||||
Posts about developing for the internet.
|
||||
|
||||
<!--more-->
|
9
content/tags/webserver/_index.md
Normal file
@ -0,0 +1,9 @@
|
||||
---
|
||||
|
||||
title: Webserver
|
||||
|
||||
---
|
||||
|
||||
Blog posts about webservers (software that runs websites).
|
||||
|
||||
<!--more-->
|
10
content/tags/youtube/_index.md
Normal file
@ -0,0 +1,10 @@
|
||||
---
|
||||
|
||||
title: YouTube
|
||||
|
||||
---
|
||||
|
||||
One of the most popular video and social media platforms. If you don't know what
|
||||
YouTube is, I don't know what to tell you.
|
||||
|
||||
<!--more-->
|
8
demo.sh
@ -1,4 +1,4 @@
|
||||
#!/bin/sh -x
|
||||
rm -rf public/
|
||||
HUGO_ENABLEMISSINGTRANSLATIONPLACEHOLDERS=true hugo -D --baseURL "https://demo.bbaovanc.com/test/$1"
|
||||
rsync -avPzc --delete-delay public/ bbaosrv:/var/www/demo.bbaovanc.com/test/$1/
|
||||
#!/bin/sh -ex
|
||||
./audit.sh
|
||||
DEST=public.demo/ ./build.sh --baseURL "https://demo.bbaovanc.com/test/$1"
|
||||
rsync -avPzc --delete-delay public.demo/ bbaosrv:/var/www/demo.bbaovanc.com/test/$1/
|
||||
|
92
hugo.yaml
Normal file
@ -0,0 +1,92 @@
|
||||
baseURL: https://bbaovanc.com
|
||||
theme: bobatheme
|
||||
defaultContentLanguage: en
|
||||
copyright: >
|
||||
<p>
|
||||
© 2021-2025 bbaovanc <a rel="license noopener noreferrer" href="https://creativecommons.org/licenses/by-sa/4.0/" target="_blank">CC BY-SA 4.0</a>
|
||||
</p>
|
||||
sectionPagesMenu: main
|
||||
enableRobotsTXT: true
|
||||
enableGitInfo: true
|
||||
|
||||
pagination:
|
||||
pagerSize: 10
|
||||
|
||||
taxonomies:
|
||||
_merge: deep
|
||||
|
||||
markup: # this just keeps the bobatheme markup styling
|
||||
_merge: deep
|
||||
|
||||
outputs:
|
||||
_merge: deep
|
||||
|
||||
outputFormats:
|
||||
_merge: deep
|
||||
|
||||
related:
|
||||
includeNewer: true
|
||||
indices:
|
||||
#- name: keywords
|
||||
# weight: 100
|
||||
- name: categories
|
||||
weight: 80
|
||||
- name: tags
|
||||
weight: 80
|
||||
- name: date
|
||||
weight: 10
|
||||
threshold: 80
|
||||
toLower: true
|
||||
|
||||
params:
|
||||
author:
|
||||
name: bbaovanc
|
||||
|
||||
# these are for the OpenGraph/Twitter embeds in Hugo
|
||||
description: My personal website
|
||||
|
||||
# these are for favicons in bobatheme (disabled by default)
|
||||
faviconSVG: favicon.svg
|
||||
appleTouchPNG: apple-touch-icon.png
|
||||
|
||||
# show reading time (enabled by default)
|
||||
readingtime: true
|
||||
|
||||
# used for "View source" (unset by default)
|
||||
gitFileURL: https://github.com/BBaoVanC/bbaovanc.com/blob/master
|
||||
gitFileIcon: code
|
||||
gitHistoryURL: https://github.com/BBaoVanC/bbaovanc.com/commits/master
|
||||
|
||||
# display a "Latest Posts" section on the homepage below its content
|
||||
homepageLatestPosts: true
|
||||
|
||||
# social media share icons
|
||||
shareButtons:
|
||||
twitter: true
|
||||
facebook: true
|
||||
linkedin: true
|
||||
reddit: true
|
||||
telegram: true
|
||||
print: true
|
||||
|
||||
|
||||
footer: >-
|
||||
See the [anonymous and privacy-friendly
|
||||
analytics](https://plausible.bbaovanc.com/bbaovanc.com) for this site,
|
||||
powered by [Plausible](https://plausible.io).
|
||||
|
||||
# see https://gohugo.io/about/hugo-and-gdpr/#all-privacy-settings
|
||||
# you probably want to keep this default
|
||||
privacy:
|
||||
_merge: deep
|
||||
|
||||
languages:
|
||||
en:
|
||||
languageName: English
|
||||
title: bbaovanc's Website
|
||||
weight: 1
|
||||
menu:
|
||||
main:
|
||||
- identifier: status-page
|
||||
name: Status
|
||||
url: https://status.bbaovanc.com
|
24
layouts/_partials/additional-head.html
Normal file
@ -0,0 +1,24 @@
|
||||
{{ if not hugo.IsServer }}
|
||||
<script defer data-domain="bbaovanc.com" src="https://plausible.bbaovanc.com/js/bobalytics.outbound-links.js"></script>
|
||||
<script>window.plausible = window.plausible || function() { (window.plausible.q = window.plausible.q || []).push(arguments) }</script>
|
||||
{{ end }}
|
||||
|
||||
{{ with resources.Get "js/share-event.js" | fingerprint "sha512" }}
|
||||
<script defer src="{{ .Permalink }}" integrity="{{ .Data.Integrity }}" crossorigin="anonymous"></script>
|
||||
{{ end }}
|
||||
|
||||
{{ if eq .Layout "search" }}
|
||||
{{ with resources.Get "css/search.css" | fingerprint "sha512" }}
|
||||
<link rel="stylesheet" type="text/css" href="{{ .Permalink }}" integrity="{{ .Data.Integrity }}" crossorigin="anonymous">
|
||||
{{ end }}
|
||||
|
||||
<link rel="stylesheet" type="text/css" href="{{ absURL "pagefind/pagefind-ui.css" }}" crossorigin="anonymous">
|
||||
<script src="{{ absURL "pagefind/pagefind-ui.js" }}" crossorigin="anonymous"></script>
|
||||
<script>
|
||||
window.addEventListener('DOMContentLoaded', (event) => {
|
||||
new PagefindUI({ element: "#search-box", showSubResults: true });
|
||||
});
|
||||
</script>
|
||||
{{ end }}
|
||||
|
||||
<link rel="me" href="https://procursus.social/@bbaovanc" />
|
56
layouts/_partials/comments.html
Normal file
@ -0,0 +1,56 @@
|
||||
{{ with resources.Get "css/comments.css" | fingerprint "sha512" }}
|
||||
<link rel="stylesheet" type="text/css" href="{{ .Permalink }}" integrity="{{ .Data.Integrity }}" crossorigin="anonymous">
|
||||
{{ end }}
|
||||
|
||||
<h2 style="margin-bottom: 0;">Comments</h2>
|
||||
<p style="margin: 0; font-size: smaller;">
|
||||
If you provide an email address, you can enable notifications for
|
||||
replies to your comment. It will not be shown publicly.
|
||||
</p>
|
||||
|
||||
<noscript>
|
||||
<i>Enable JavaScript to see the comment section.</i>
|
||||
</noscript>
|
||||
|
||||
{{ $url := .Permalink }}
|
||||
{{ if .IsTranslated }}
|
||||
{{ with index .AllTranslations 0 }}
|
||||
{{ $url = .Permalink }}
|
||||
{{ end }}
|
||||
{{ end }}
|
||||
|
||||
|
||||
<script data-isso-id="{{ $url }}"
|
||||
data-isso-default-lang="{{ .Language.Lang }}"
|
||||
data-isso-css="true"
|
||||
data-isso-max-comments-top="inf"
|
||||
data-isso-max-comments-nested="inf"
|
||||
data-isso-reveal-on-click="5"
|
||||
{{/*
|
||||
data-isso-avatar-bg="#111"
|
||||
data-isso-avatar-fg="#9abf88 #5698c4 #e279a3 #9163b6 ..."
|
||||
*/}}
|
||||
data-isso-vote="true"
|
||||
{{/*
|
||||
data-isso-vote-levels=""
|
||||
*/}}
|
||||
data-isso-feed="true"
|
||||
data-isso-require-email="false"
|
||||
data-isso-reply-notifications="true"
|
||||
data-isso-reply-notifications-default-enabled="true"
|
||||
|
||||
{{ with (.GetTerms "authors") }}
|
||||
{{ $authorHashes := slice }}
|
||||
{{ range . }}
|
||||
{{ with .Params.issoUserID }}
|
||||
{{ $authorHashes = $authorHashes | append . }}
|
||||
{{ end }}
|
||||
{{ end }}
|
||||
|
||||
data-isso-page-author-hashes="{{ delimit $authorHashes "," }}"
|
||||
{{ end }}
|
||||
|
||||
src="https://isso.bbaovanc.com/js/embed.min.js">
|
||||
</script>
|
||||
|
||||
<section id="isso-thread" data-title="{{ .Title }}"></section>
|
5
layouts/_partials/page-metadata/custom-full.html
Normal file
@ -0,0 +1,5 @@
|
||||
{{/* TODO: implement this
|
||||
<span class="page-metadata-item" aria-label="comments counter">
|
||||
<a href="#isso-thread">comments</a>
|
||||
</span>
|
||||
*/}}
|
@ -1,63 +0,0 @@
|
||||
{{ if ne .Site.BaseURL "https://bbaovanc.com" }}
|
||||
<i>Comment section is not available during development previews.</i>
|
||||
{{ else }}
|
||||
|
||||
<noscript>
|
||||
<style>
|
||||
#comments-hr {
|
||||
display: none;
|
||||
}
|
||||
</style>
|
||||
|
||||
<small>
|
||||
<i>Enable JavaScript to see the comment section.</i>
|
||||
</small>
|
||||
</noscript>
|
||||
|
||||
{{ $url := .Permalink }}
|
||||
|
||||
{{ if .IsTranslated }}
|
||||
{{ with index .AllTranslations 0 }}
|
||||
{{ $url = .Permalink }}
|
||||
{{ end }}
|
||||
{{ end }}
|
||||
|
||||
<script>
|
||||
var remark_config = {
|
||||
host: "https://remark.bbaovanc.com",
|
||||
site_id: "bbaovanc.com",
|
||||
components: [
|
||||
"embed",
|
||||
//"last-comments",
|
||||
//"counter",
|
||||
],
|
||||
url: "{{ $url }}", // make this permalink the main language so all languages have the same comments
|
||||
max_shown_comments: 10,
|
||||
page_title: "{{ .Title }}",
|
||||
locale: "{{ .Language.Lang }}",
|
||||
show_email_subscription: true,
|
||||
simple_view: false,
|
||||
};
|
||||
|
||||
if (window.matchMedia('(prefers-color-scheme: light)').matches) {
|
||||
remark_config["theme"] = "light";
|
||||
} else {
|
||||
remark_config["theme"] = "dark";
|
||||
}
|
||||
</script>
|
||||
<script>!function(e,n){for(var o=0;o<e.length;o++){var r=n.createElement("script"),c=".js",d=n.head||n.body;"noModule"in r?(r.type="module",c=".mjs"):r.async=!0,r.defer=!0,r.src=remark_config.host+"/web/"+e[o]+c,d.appendChild(r)}}(remark_config.components||["embed"],document);</script>
|
||||
|
||||
<script>
|
||||
const darkModeMediaQuery = window.matchMedia('(prefers-color-scheme: light)');
|
||||
darkModeMediaQuery.addListener((e) => {
|
||||
if (e.matches) {
|
||||
window.REMARK42.changeTheme('light');
|
||||
} else {
|
||||
window.REMARK42.changeTheme('dark');
|
||||
}
|
||||
});
|
||||
</script>
|
||||
|
||||
<div id="remark42"></div>
|
||||
|
||||
{{ end }}
|
3
layouts/search.html
Normal file
@ -0,0 +1,3 @@
|
||||
{{ define "main" }}
|
||||
<div id="search-box"></div>
|
||||
{{ end }}
|
4
staging.sh
Executable file
@ -0,0 +1,4 @@
|
||||
#!/bin/sh -ex
|
||||
./audit.sh
|
||||
DEST=public.staging/ ./build.sh --baseURL "https://demo.bbaovanc.com/staging/$1"
|
||||
rsync -avPzc --delete-delay public.staging/ bbaosrv:/var/www/demo.bbaovanc.com/staging/$1/
|