有點能體會到水影片的感覺了,是的這篇文章很水。
這是把語法上色從 chroma 改成 prism.js/highlight.js 又改成 shiki 的心得,網路上你哪裡能找到全部試過一輪的心得呢。
這是 Hugo 內建的語法上色方式,以 Blowfish 主題而言,可以在 assets/css/compiled/main.css
找到,然後你會發現多到發瘋的高亮選項,哪個正常人會去改這個。想改的原因不外乎就是顏色醜,上色語法錯誤,Blowfish 兩個都發生了於是考慮別的上色方案。
一樣保持著一勞永逸的想法(雖然真的一勞永逸的次數好像滿少的)先去查哪個 highlighter 好,2018 2019年那些文章大概都說 Prism.js,說維護的比較勤 contributor 比較多,那就先選 Prism.js 好了。
就說是來水文章的,這兩個對我來說根本沒啥差別,Prism.js 裝好沒半小時去官方 Github 看發現上次更新已經是 2022,於是果斷換成 Highlight.js,裝了也很輕鬆兩行 <link>
<script>
就搞定,只是痛苦這裡才開始。首先,我已經知道 PageSpeed Insights 這個邪惡的東西,裝完之後手賤去測試果然慢了不少,因為他是用戶載入頁面後即時渲染的;再來是暗色模式支援,還自己寫了四個 javascript 搞定亮暗主題轉換問題:
幫 Highlight.js 加了一堆東西
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
| <!-- partials/extend-head.html -->
<link id="light-mode-css" rel="stylesheet" as="style" crossorigin="anonymous" referrerpolicy="no-referrer"
href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.10.0/styles/nnfx-light.min.css"
integrity="sha256-roHDdCpzJHruZzg09T0xn8BZQy6PDIWCR2mjy3Sp1iA=" />
<link id="dark-mode-css" rel="stylesheet" as="style" crossorigin="anonymous" referrerpolicy="no-referrer"
href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.10.0/styles/nnfx-dark.min.css"
integrity="sha256-aZYmPW0FYMBJ2LAv+S8cuVc7kCUaKqoq12pf4YMakFY=" />
<script crossorigin="anonymous" referrerpolicy="no-referrer"
src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.10.0/highlight.min.js"
integrity="sha256-Rx75rpDEB69ED83Ejt/utWIQazJnvRLZkHHBYvtS7TI="></script>
<script crossorigin="anonymous" referrerpolicy="no-referrer" async
src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.10.0/languages/matlab.min.js"
integrity="sha256-b4Mp6eYO0H7GNjWkL4yUNrSbUg/lKvwuxk9KZWdKtCg="></script>
<script>hljs.highlightAll();</script>
<script src="{{ "js/hljs-copy.js" | absURL }}"></script>
|
1
2
3
4
5
6
7
8
9
10
| // appearance.js
const setHighlightJsTheme = () => {
const isDarkMode = document.documentElement.classList.contains("dark");
document.getElementById('light-mode-css').disabled = isDarkMode;
document.getElementById('dark-mode-css').disabled = !isDarkMode;
};
// 還要在每個this.updateLogo下面增加
this.updateLogo?.(targetAppearance);
setHighlightJsTheme();
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
| // static/js/hljs-copy.js
document.addEventListener('DOMContentLoaded', (event) => {
const container = document.querySelector('body');
container.addEventListener('click', (event) => {
if (event.target.classList.contains('copy-btn')) {
const button = event.target;
const codeBlock = button.previousElementSibling;
const text = codeBlock.innerText;
navigator.clipboard.writeText(text).then(() => {
button.innerText = 'Copied!';
setTimeout(() => {
button.innerText = 'Copy';
}, 2000);
}).catch(err => {
console.error('Failed to copy text: ', err);
});
}
});
document.querySelectorAll('pre code').forEach((codeBlock) => {
const button = document.createElement('button');
button.className = 'copy-btn';
button.type = 'button';
button.innerText = 'Copy';
codeBlock.parentNode.appendChild(button);
});
document.querySelectorAll('pre code').forEach((block) => {
hljs.highlightElement(block);
});
});
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
| /* custom.css */
pre {
white-space: pre !important;
overflow-x: auto !important;
tab-size: 2 !important;
-moz-tab-size: 2 !important;
padding: 0 !important;
position: relative;
}
.copy-btn {
position: absolute;
top: 0;
right: 0;
color: var(--text-color-neutral-700);
background: rgb(var(--color-neutral-700), 0.);
border: none;
padding: 1.2px 12px;
cursor: pointer;
font-size: 0.875rem;
border-radius: 0 0 0 10px; /* 左下角圓弧 */
transition: background-color 0.3s ease; /* 平滑過渡效果 */
}
.copy-btn:hover {
background-color: rgba(var(--color-neutral-700), 0.3); /* 滑鼠經過時顯示背景顏色 */
}
.dark .copy-btn {
background-color: transparent;
}
.dark .copy-btn:hover {
background-color: rgba(255, 255, 255, 0.1); /* 暗黑模式下滑鼠經過時的背景顏色 */
}
|
奇怪不是兩個 javascript 嗎,哪來的四個?因為還有兩個寫完發現寫太爛打掉重練,單純只加上 Highlight.js 確實是像教學[1], [2], [3]一樣複製貼上就結束了,但是改成 Highlight.js 後缺失的主題切換和複製按鈕都要重新寫,關於 CSP referrerpolicy, defer/async, crossorigin, integrity 的設定教學也沒講到,查到 CSP 之後又用 Cloudflare Workers 寫了一個修改 HTTP headers 的程式:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
| // Cloudflare Workers
const cdns = `
https://cdnjs.cloudflare.com
https://cdn.jsdelivr.net
https://fonts.googleapis.com
https://fonts.gstatic.com
`.trim().replace(/\n\s+/g, ' ');
addEventListener('fetch', event => {
event.respondWith(handleRequest(event.request))
})
async function handleRequest(request) {
let response = await fetch(request)
let newHeaders = new Headers(response.headers)
newHeaders.set('Strict-Transport-Security', 'max-age=31536000; includeSubDomains; preload')
newHeaders.set('X-Content-Type-Options', 'nosniff')
newHeaders.set('X-XSS-Protection', '1; mode=block')
newHeaders.set('Content-Security-Policy', `
object-src 'none';
default-src 'self';
manifest-src 'self' https://*.zsl0621.cc;
connect-src 'self' ${cdns} https://www.google-analytics.com;
font-src 'self' ${cdns};
img-src 'self' https://*.zsl0621.cc;
script-src 'self' https://*.zsl0621.cc ${cdns} https://www.googletagmanager.com https://analytics.google.com https://static.cloudflareinsights.com 'unsafe-inline';
style-src 'self' https://*.zsl0621.cc ${cdns} 'unsafe-inline'
`.replace(/\n/g, ' ').trim())
newHeaders.set('X-Frame-Options', 'SAMEORIGIN')
newHeaders.set('Referrer-Policy', 'strict-origin')
newHeaders.set('Permissions-Policy', 'geolocation=(self), microphone=(), camera=()')
newHeaders.set('Cache-Control', 'public, max-age=31536000')
const origin = request.headers.get('Origin')
if (origin && origin.match(/^https:\/\/.*zsl0621\.cc$/)) {
newHeaders.set('Access-Control-Allow-Origin', origin)
} else {
newHeaders.set('Access-Control-Allow-Origin', '*')
}
return new Response(response.body, {
status: response.status,
statusText: response.statusText,
headers: newHeaders
})
}
|
越搞越多跟想像的三行優雅解決完全不一樣...都破百行了,最重要的是原本用好的超過100分經過字體和高亮 CDN 以及我外行人寫的 javascript,速度直接噴到剩下50分:
※ Highlight.js 手機版跑分結果
※ Highlight.js 桌面版跑分結果
原本的沒有存結果,這是用 Cloudflare Pages Rollbacks 功能留下來的頁面跑分的,應該也享受他們的 CDN 服務,記得剛部屬完 Highlight.js 後手機測速有時候還跑不到50分。
我辛苦弄這麼久的結果雖然是好看了但是分數有夠難看,那我之前的努力算什麼,就在我覺得好像沒救的時候看到了這篇文章,插入也有夠簡單而且內建亮暗主題切換,重點是純靜態,拿他的網頁去跑分即使程式碼數量比我多的也是輕鬆跑到99, 100,好啊心態沒了,馬上改全刪,於是現在的跑分成績:
※ Shiki 手機版跑分結果
※ Shiki 桌面版跑分結果
完美,回來了。
複製功能自己寫完發現其實是 Blowfish 的問題,暫時就先不放了。
eallion 寫的 Shiki 教學就是我最喜歡的那種,有介紹原因,直接教學,沒有廢話,沒有拖泥帶水,清楚了當。
最後,你說70分和100分體感有差嗎?完全沒差,但是我比較爽。
更新:發現速度除了 Highlight.js 以外字型影響也很大
當初看了這篇文章把字體從 Cloudflare Fonts 換成 Google Fonts 速度大暴跌,那時沒注意到導致花了很久除錯,這邊附上使用 LXGW 字體各種 CDN 的速度,改完馬上測試,未被 CDN 服務商快取:
來源 | 手機 / 桌面 |
---|
Default font | 99 / 100 |
Google Fonts | 55 / 72 |
Cloudflare Fonts (cdnjs) | 60 / 85 |
jsdelivr lxgw-wenkai-* | |
- tc-web, screen-webfont | 55 / 70±5 |
- tc-webfont | 58 / 82 |
- screen-web | 59 / 87 |
- screen-web + preload/preconnect | 86 / 92 |
- screen-web + preload/preconnect/CDN cache | 90 / 99 |
網路世界變化很快不到一年就大洗牌,另外幫他的文章勘誤(或者說更新),至少在今天 (2024/8/18) 我的測試結果是這樣的:
原始碼,現在會人間蒸發,直接替換成一大串如下圖的 Embedded CSS/Internal CSS
現在沒有這些 CSS,就是原本的 <link>
而已。
必須要網站在 Cloudflare 中是設定 Proxied 的狀態
我的網站分別部署在 Cloudflare/Github Pages,只有 Cloudflare 有開啟代理,實際測試兩者皆成功套用字體
憑空產生一個 /cf-fonts/ 的請求路徑
使用 Github Pages 沒有,會跳轉自己設定的 404 錯誤,部署在 Cloudflare Pages 的網站會進 HTTP ERROR 404。
實測之後得知,在某些條件下,用了 Cloudflare Fonts 不一定會讓網頁變快,反而可能變慢,但是體感可能完全感覺不出來。
確實沒差,但我只是想跑分。
這個服務還在 beta 測試版,以後可能還會變更好。
這句話應該寫在網站第一行...我認真看完之後照作才發現現在已經改善很多。