ここには、すべての本テーマの使用者の相互リンクが記録されています。
-
Dr.Yue_plus: http://arknights.theme.hexo.yue.zone/
-
Dr.Ocatator https://ocatator.github.io/
- Dr.Ye: https://laurenfrost.github.io/
- Dr.tyqtyq https://tyq0712.github.io/
- Dr.Angine https://angine.tech/
- Dr.sjfhsjfh https://sjfh.top/
- Dr.Voilone https://note.voiblog.top/
- Dr.yuanli-LFSWhttps://blog.yuanli-lfsw.com/
- Dr.Laplacian: https://rhinelab.kr
- Dr.Chen: https://light-of-hers.github.io
- Dr.Linyee https://linyee.world/
- Dr.Flacier https://flacier.us.kg/
- Dr.LZW https://lzwnb.github.io/blog/
- Dr.GrandpaFox https://grandpafox.online/
- Dr.未雨屏 https://weiyuping.top/
- 飞龙project https://schale.top/
- tomorinao-www https://ghpage.wwnao.xyz
- Mornikar https://mornikar.github.io/Mornikar/
このテーマを使用した場合、Pull Requests を発起してここに相互リンクを貼ることを大歓迎します。
- Node.js
16.13.x以上 - 最新版 Hexo
Hexo
6.0.0以上; hexo-cli4.3.0以上;
hexo init Hexo
cd Hexo
npm install
git clone https://github.com/Yue-plus/hexo-theme-arknights.git themes/arknights --depth=1npm ユーザー:
npm install hexo-server hexo-browsersync hexo-renderer-pug --saveyarn ユーザー:
yarn add hexo-server hexo-browsersync hexo-renderer-pug-
Hexo 公式サイト を参考に
<Hexo>/_config.ymlを変更します。-
theme:初期値のlandscapeをarknightsに変更してください。 -
コードハイライトを有効にします:
highlight: hljs: true
-
-
<Hexo>/themes/arknights/_config.ymlを 切り取ってHexoディレクトリに移動し、·_config.arknights.yml` という名前に変更します。参考:
テーマの設定ファイルは、中国語のコメントを参考に変更できます。
必要に応じて Hexo/source/ ディレクトリに以下のファイルを追加します
CNAME:GitHub Pages のデプロイ時のカスタムドメインimg/:ディレクトリ下のAlipay.pngとWeChat.pngを自分の受取用QRコード(1:1 比率のpng画像)にします;
必要に応じて Hexo/themes/arknights/source/ ディレクトリ下の以下を変更します
favicon.ico:ブラウザのタブ上のアイコン(64*64、解像度が高すぎると表示されません)
README.md: デプロイリポジトリの README
-
執筆 | Hexo を参考にします。
-
テーマリポジトリの Hexo ブランチにはいくつかの サンプルテキスト があります
-
記事にタグとカテゴリを追加し、より多くの特性は Hexo | Front-matter を参考にできます、例:
--- title: 'Hello World !' date: 2020-04-15 21:54:02 tags: code category: Example ---
-
<!-- more -->の前の内容は要約と呼ばれ、ホームページに表示され、本文にも表示するかどうかを設定できます。
-
例えば、
aboutページを新規作成するHexoディレクトリでhexo new page 'about'を実行します- その後、
Hexo/source/ディレクトリにaboutフォルダが追加されます
-
Hexo/source/about/index.mdファイルを編集します -
_config.arknights.ymlを編集し、リンクを追加します:menu: About: /about
この設定は Hexo の設定ファイル _config.yml の約 88 行目にあります。
# Pagination
## Set per_page to 0 to disable pagination
per_page: 10
pagination_dir: pageper_page: を 0 に変更すればよいです。
このテーマはValineをサポートしています。
Valineのクイックスタートを参考に、Hexoディレクトリの_config.arknights.ymlファイルを変更してください:
valine:
enable: false
app_id: # APP ID
app_key: # APP KEY
server_url: # APP DOMAIN(LeanCloud 国際版)
avatar: 'retro' # (''/mp/identicon/monsterid/wavatar/robohash/retro/hide)
avatar_cdn: 'https://dn-qiniu-avatar.qbox.me/avatar/' # カスタム avatar CDNメール通知を有効にする:zhaojun1998 / Valine-Admin
注意! Valine を LeanCloud国際版 で使用する場合のみ、
server_url:を設定する必要があります。 この設定は、LeanCloud アプリの設定 -> アプリケーション証明書 -> ドメインホワイトリスト -> Requestドメインで、.api.lncldglobal.comで終わるドメインを見つけ、https://のプレフィックスを追加すればよいです。
このテーマは Gitalk をサポートしています。
Gitalk の公式ドキュメントを参考に、Hexo ディレクトリの _config.arknights.yml ファイルを変更してください:
gitalk:
enable: false
client_id: # GitHub アプリの Client ID
client_secret: # GitHub アプリの Client Secret
repo: # コメントデータを保存する GitHub リポジトリ
owner: # その GitHub リポジトリの所有者
admin: [] # その GitHub リポジトリに書き込み権限を持つユーザー
# 例: [adminA,adminB]
id: # (オプション) ページの一意の識別子
# 例: location.pathnameこのテーマは Waline をサポートしています。
Waline の公式ドキュメントを参考に、Hexo ディレクトリの _config.arknights.yml ファイルを変更してください:
waline:
enable: false
server_url: # Server_Url
locale:
placeholder: "コメントをお待ちしています~"
# sofa: "コメントをお待ちしています~"
# nick: "ニックネーム"
# mail: "メールアドレス"
# link: "URL"
# submit: "送信"Walineはロケールオプションを提供しており、インターフェースの言語と表示テキストをカスタマイズするために使用できます。デフォルトでは、Walineは組み込みの多言語テキストを使用します。現在の言語がサポートされていない場合、自動的にen-US(アメリカ英語)にフォールバックします。
デフォルトで表示されるテキストを上書きするために、一部のフィールドを設定できます。ロケールオプションでは、すべてのフィールドはオプションであり、指定されていないフィールドはデフォルト値を保持します。
レベル関連:
level${number}: レベル${number}の表示テキストリアクション関連:
reactionTitle: リアクションタイトル
reaction0: リアクション1のテキスト
reaction1: リアクション2のテキスト
reaction2: リアクション3のテキスト
reaction3: リアクション4のテキスト
reaction4: リアクション5のテキスト
reaction5: リアクション6のテキスト
reaction6: リアクション7のテキスト
reaction7: リアクション8のテキスト
reaction8: リアクション9のテキストUI関連:
nick: ニックネーム
mail: メールアドレス
link: ウェブサイト
placeholder: コメント欄プレースホルダー
sofa: コメントがまだない時の表示テキスト
submit: 送信ボタンテキスト
comment: コメントボタンテキスト
refresh: 更新ボタンテキスト
more: さらに読み込むボタンテキスト
uploading: アップロード中表示テキスト
login: ログインボタンテキスト
admin: 管理者バッジ
sticky: 固定表示
word: 文字
anonymous: 匿名ユーザー名
optional: 任意項目表示テキスト
gifSearchPlaceholder: GIF検索プレースホルダー
oldest: 古い順
latest: 新しい順
hottest: 人気順上記設定項目のテキストはページに表示されます。
エラーメッセージ関連:
nickError: ニックネームが条件を満たしていない場合のエラーメッセージ
mailError: メールアドレスが条件を満たしていない場合のエラーメッセージ
wordHint: コメント文字数に関するエラーメッセージ。$0、$1、$2は自動的に文字数の下限、上限、現在の文字数に置き換えられます。コメント時間関連:
seconds: 秒前
minutes: 分前
hours: 時間前
days: 日前
now: たった今管理関連:
approved: 承認済み
waiting: 承認待ち
spam: スパムコメント
unsticky: 固定を解除アクセシビリティ関連(アクセシビリティサービスのみで使用され、ページには表示されません):
like: いいね
cancelLike: いいね取消
reply: 返信ボタンのラベル
cancelReply: 返信取消ボタンのラベル
preview: プレビューボタンのラベル
emoji: 絵文字ボタンのラベル
gif: GIFボタンのラベル
uploadImage: 画像アップロードボタンのラベル
profile: プロフィールページのラベル
logout: ログアウトボタンのラベルこのテーマは Artalk をサポートしています。
Artalk の公式ドキュメントを参考に、Hexo ディレクトリの _config.arknights.yml ファイルを変更してください:
artalk:
enable: false
server: https://artalk.server.instance/ # あなたの Artalk サービスのアドレス
site_name: My Blog # サイト名、複数のサイトを区別するために使用(オプション)このテーマは Utterances をサポートしています。
Utterances 公式ドキュメントを参考に、Hexo ディレクトリの _config.arknights.yml ファイルを変更してください:
utterances:
enable: false
repo: # GitHub リポジトリの所有者と名前、形式:owner/repo
issue_term: pathname # 選択肢: pathname | url | title | og:title
theme: github-light # 選択肢: github-light | github-dark | preferred-color-scheme | github-dark-orange | icy-dark | dark-blue | photon-dark | boxy-light使用前に必要な設定:
- GitHub リポジトリが公開されていることを確認
- リポジトリに utterances app をインストール
- リポジトリで Issues が有効になっていることを確認
このテーマは Giscus コメントシステムをサポートしています。
Giscus 公式ドキュメントを参考に、Hexo ディレクトリの _config.arknights.yml ファイルを変更してください:
giscus:
enable: false
repo: # GitHub リポジトリの所有者と名前、形式:owner/repo
repo_id: # リポジトリ ID、giscus ページから取得
category: # discussion カテゴリ名
category_id: # カテゴリ ID、giscus ページから取得
mapping: pathname # ページ ↔️ discussion マッピング関係
strict: 0 # 厳密なタイトルマッチングを有効にする 0 | 1
reactions_enabled: 1 # メイン投稿でのリアクションを有効にする 0 | 1
emit_metadata: 0 # discussion のメタデータを出力する 0 | 1
input_position: bottom # コメント入力ボックスの位置: top | bottom
lang: ja # 言語
loading: lazy # 懒惰読み込み: lazy | 空で無効化
crossorigin: anonymous # CORS 設定方法1:単一テーマ(固定テーマ、サイトテーマに追従しない)
giscus:
theme: preferred_color_scheme # または他のテーマ名方法2:明暗テーマ個別設定(推奨、自動テーマ切り替えサポート)
giscus:
theme_light: light # ライトモードテーマ
theme_dark: dark # ダークモードテーマ方法3:カスタムCSS(上級者向け)
giscus:
theme: https://your-domain.com/path/to/custom-giscus-theme.css- GitHub テーマシリーズ:
light,dark,dark_dimmed,dark_high_contrast,dark_tritanopia,light_high_contrast,light_tritanopia,light_protanopia,dark_protanopia - 特殊テーマ:
preferred_color_scheme,transparent_dark - ボーダーレステーマ:
noborder_light,noborder_dark,noborder_gray - サードパーティテーマ:
gruvbox,gruvbox_dark,gruvbox_light,purple_dark,cobalt - Catppuccin テーマ:
catppuccin_latte,catppuccin_frappe,catppuccin_macchiato,catppuccin_mocha - その他:
fro
giscus:
mapping: pathname # 選択肢:
# pathname - ページパスを使用
# url - 完全なURLを使用
# title - ページタイトルを使用
# og:title - og:title メタタグを使用
# specific - 特定の文字列を使用(term と組み合わせ)
# number - 特定のdiscussion番号を使用(discussion_number と組み合わせ)
# mapping が specific の場合に使用
term: "your-specific-term"
# mapping が number の場合に使用
discussion_number: 123giscus:
# カスタム discussion 説明
description: "コメント"
# ドメイン制限
origin: "https://your-domain.com"
# カスタムバックリンク
backlink: "https://your-domain.com"より良いセキュリティ制御のため、サイトルートに source/giscus.json ファイルを作成できます:
{
"origins": ["https://your-domain.com"],
"originsRegex": ["http://localhost:[0-9]+"],
"defaultCommentOrder": "newest"
}ドメイン検証優先順位:YAML設定 > JSON完全一致 > JSON正規表現 > デフォルト許可
// メッセージイベントを監視
giscusManager.addMessageHandler((data) => {
console.log('Giscus message:', data)
})
// 設定を更新
giscusManager.sendMessage({ setConfig: { theme: 'dark' } })
// テーマを同期
giscusManager.syncTheme()使用前に必要な設定:
- GitHub リポジトリが公開されていることを確認
- リポジトリに giscus app をインストール
- リポジトリで Discussions が有効になっていることを確認
このテーマは数学公式を表示するための2つの方法をサポートしています:
数学公式を表示するために、Hexoフィルターの hexo-filter-mathjax を静的レンダリングとして使用することができます。
数学公式をより良く処理するためのマークダウンレンダラー hexo-renderer-pandoc に切り替えることをお勧めします。
-
Hexoディレクトリで以下のコマンドを実行します:
# hexo-filter-mathjaxプラグインをインストール cnpm install hexo-filter-mathjax --save # キャッシュをクリア hexo clean
-
以下の内容を
<Hexo>/_config.ymlファイルに追加します:mathjax: tags: none # あるいは 'ams' また 'all' single_dollars: true # $⋯$ で囲んでインライン LaTeX 方程式を書く cjk_width: 0.9 # CJK 統合漢字の幅 normal_width: 0.6 # 正常文字(等幅)の幅 append_css: true # CSS を全部のページに加える every_page: false # true に設定されると、記事の頭の `mathjax` の値を問わずに、 mathjax が使用される
-
mathjax を利用したい記事の Front-matter に
mathjax: trueを追加すると:--- title: On the Electrodynamics of Moving Bodies categories: Physics date: 1905-06-30 12:00:00 mathjax: true ---
記事の中で LaTeX 方程式が使用可能になります。
-
インライン方程式(……
$<数式>$……)は、頭の$と後ろの$の間で間隔は不要です:- $ \epsilon_0 $ + $\epsilon_0$ - $ \frac{\partial}{\partial t} $ + $\frac{\partial}{\partial t}$
-
LaTeX と Markdown の文法の差異にご注意ください。必要とされる時は半角のバックスラッシュ
\(日本語環境では半角円記号 '¥')でエスケープしてください:- $\epsilon_0$ + $\epsilon\_0$ - \begin{eqnarray*} + \begin{eqnarray\*}
このテーマでは、MathJax を利用して、数式をブラウザサイドで動的レンダリングすることもできます。
-
まずは、デフォルトのレンダラー hexo-renderer-marked をアンインストールし、その代わりとして hexo-renderer-kramed をインストールします。
$ npm uninstall hexo-renderer-marked --save $ npm install hexo-renderer-kramed --save
-
また、
<Hexo>/_config.ymlを、以下のように変更します。# 公式支持 mathjax: - enable: false + enable: true version: '2.6.1' # 重要
-
そして、記事の中で以下のように LaTeX 文法を利用して、数式を表示出来ます。
% インライン数式 % 両側に「`」を付けてください。「`」と「$」の間に隙間あってはいけません。 `$\sigma$` % ディスプレイ数式 $$ \begin{aligned}f(x) &= \sum_{i=1}^{\infty}{\frac{x}{2^i}} \\ &= x\end{aligned} $$
-
この方法を使うと、 LaTeX と Markdown の文法の差を気にせずに数式を書くことができます。 以下のように数式を書いても、何の問題もなくレンダリングされます。
\epsilon_0 \begin{eqnarray*}
レンダラー hexo-renderer-marked は他の設定もできますので、公式ドキュメントを参考にしてみてください:https://github.com/sun11/hexo-renderer-kramed
以上の方法は、それぞれに長所と短所があります:
- 動的レンダリングは、 LaTeX 文法のエスケープせずに書くことができる為、他のフレームワークやブログサイトからの記事導入は簡単にできます。ですが、クライアントサイドレンダリングですので、ページ上の数式表示は若干遅れます。
- 静的生成は、数式を素早く表示することができますが、 LaTeX 文法のエスケープをしなくてはいけません。
- hexo-renderer-pandoc を利用して、文法をエスケープする手間がかからなくても、数式を素早く表示できますが、 Pandoc をインストールしなくてはいけません。
Hexo ディレクトリの _config.arknights.yml ファイルを変更します:
# グラフのサポート
mermaid:
- enable: false
+ enable: true
version: '8.13.5'このテーマは mermaid-js を使用して各種グラフを描画します。例を見る
支持: フローチャート | シーケンス図 | クラス図 | 状態図 | エンティティ関係図 | ユーザージャーニーマップ | ガントチャート | 命令図 | パイチャート
構文:
<div class="mermaid">
graph LR
A[Hard edge] -->|Link text| B(Round edge)
B --> C{Decision}
C -->|One| D[Result one]
C -->|Two| E[Result two]
</div>もし コードブロック を使い慣れていれば完全にサポートします。
依存:hexo-wordcount:
npm ユーザー:
cnpm install hexo-wordcount --saveyarn ユーザー:
yarn add hexo-wordcountその後、Hexo ディレクトリ の下の _ config.arknights.yml ファイルを変更する:
post:
count: true # 文字数統計を表示するかどうか
time: true # 読書時間統計を表示するかどうかVercount を使用してブラウズ統計を取得します。元の不蒜子サービスの不安定性により、より信頼性の高いVercountサービスに置き換えられました。
Hexoディレクトリ の下にある _ config.arknights.yml ファイルを変更して有効にするには:
vercount:
enable: false
sitePV: true # サイト総アクセス数
siteUV: true # サイト訪問者数
pagePV: true # ページアクセス数修正された hexo-blog-encrypt プラグインはこのトピックに適合して統合されています(現在は default と up トピックのみがサポートされています)。
もしこの前にインストールした場合は、Hexo ディレクトリの
package.jsonからhexo-blog-encrypt依存を削除し、次のコマンドを実行してくださいnpm i hexo clean詳細構成リファレンス hexo-blog-encrypt/ReadMe.zh.md
Hexo/_config.yml ファイルに次の内容を追加します。
# Security
encrypt: # hexo-blog-encrypt
abstract: Rhodes Islandと™ 弱神経接続を取得するにはパスワードが必要です
message: Rhodes Islandと入力してください™ 弱神経接続を取得する際のパスワード:
tags:
- {name: tagName, password: パスワードA}
- {name: tagName, password: パスワードB}
wrong_pass_message: Rhodes Islandと™ パスワードの有効化に失敗しました。再試行してください。
wrong_hash_message: Rhodes Islandと™ 有効パスワードが失敗しました。現在は一時権限を使用して表示されています。または記事の Front-matter セクション内の設定:
---
title: Hello World
tags:
- 日記として暗号化
date: 2016-03-30 21:12:21
password: mikemessi
abstract:Rhodes Islandと™ 弱神経接続を取得するにはパスワードが必要です
message:Rhodes Islandと入力してください™ 弱神経接続を取得する際のパスワード:
wrong_pass_message:Rhodes Islandと™ パスワードの有効化に失敗しました。再試行してください。
wrong_hash_message:Rhodes Islandと™ 有効パスワードが失敗しました。現在は一時権限を使用して表示されています。
---デフォルトでオンになっています。オフにするには、Hexo/_config.arknights.yml ファイルで次の手順に従います。
search:
enable: falseサイドバーにビルド時間の表示を追加できます。デフォルトでは無効になっています。有効にするには、Hexo/_config.arknights.yml ファイルで次のように設定してください:
build_time: trueHexo サポートの Front-matter もサポート:
# 投稿/更新日
post-time: true/false
# 記事の読み込み時間/語数の統計
post-count: true/false
# 記事の読み取り回数
vercount: true/false
# 以上すべてオン/オフ
post-info: true/false
# サイドバーのディレクトリ
post-index: true/false
# に報いる
reward: true/false{% note/warning/success/failure/detail [title] [open/fold] [color] %}
content
{% end[note/warning/success/failure/detail] %}
ヒント、警告、エラーなどのブロックコンテンツを追加します。その中で、note/warning/success/failure はアイコンがあり、detail はアイコンがありません。
{% hide content %}
コンテンツを非表示にし、content は markdown レンダリングをサポートし、引用符を使用する必要はありません。
{% linkcard %}
Title1:
avatar: https://someLink/someAvatar.png
src: https://someLink/
img: https://somelink/somePicture.png
descr: someDescr
style:
color: someColor
Title2:
avatar: https://someLink/someName.png
src: https://someLink/
{% endlinkcard %}
友達チェーンのセットを生成できます。タイトル(title)、リンク(src)は必須です。スタイル(style)は CSS フォーマットに準拠しています。
Hexo 標準の コードブロック に加え、本テーマは VS Code スタイルの Monaco Editor をサポートしています。
{% editor javascript %}
/* global hexo */
'use strict';
function render(data) {
return hexo.render.renderSync({ text: data, engine: 'markdown' });
}
hexo.extend.tag.register('hide', (args) => {
let content = ''
args.forEach((item) => {
content += ' ' + item
});
return `<span class="hide"><object>${render(content.slice(1)).trim()}</object></span>`;
})
{% endeditor %}
editor タグは次のパラメータをサポートします:
[language, [theme, [readOnly, [height]]], [...extras(key:value)]]
languageのデフォルトはplaintextです;themeのデフォルトはvs-darkです;readOnlyのデフォルトはtrueです;heightのデフォルトは300pxです。
あまり使われないパラメータは extras で渡すことができます。例えば、下の例は列数が 40 を超えた時に折り返し(ワードラップ)を有効にします:
{% editor javascript hc-black wordWrap:`wordWrapColumn` wordWrapColumn:40 wrappingIndent:`indent` %}
/* global hexo */
'use strict';
function render(data) {
return hexo.render.renderSync({ text: data, engine: 'markdown' });
}
hexo.extend.tag.register('hide', (args) => {
let content = ''
args.forEach((item) => {
content += ' ' + item
});
return `<span class="hide"><object>${render(content.slice(1)).trim()}</object></span>`;
})
{% endeditor %}
追加の拡張パラメータは Monaco Editor ドキュメント を参照してください。具体的なスタイルの反映例は PR #215 をご覧ください。
Hexo/source/css/ ディレクトリに自分の CSS ファイルを置くことができます。
Hexo/source/js/ ディレクトリに自分の JavaScript スクリプトファイルを置くことができます。
次に Hexo/_config.arknights.yml ファイルを変更します:
# `<head>` タグ内に CSS スタイルシートを導入
stylesheets:
+ - /css/custom.css
# `<body>` の末尾に JavaScript スクリプトを導入
scripts:
+ - /js/custom.jsリソースフォルダはユーザーリソースを保存する場所です。
_postsフォルダ以外で、先頭が_(アンダースコア)で名付けられたファイル/フォルダや隠しファイルは無視されます。 Markdown と HTML ファイルは解析されてpublicフォルダに置かれ、他のファイルはコピーされます。—— Hexo 公式ドキュメントより
| ブレンチ | 説明 |
|---|---|
| main | 比較的安定したバージョン |
| gh-pages | github-page |
| hexo | Hexo ファイルとテスト用 .md ファイル |
TypeScript は手動でコンパイルする必要があります。typescript をグローバルにインストールした後、arknights\source\js\_src ディレクトリで tsc を実行してコンパイルしてください。
これはホットリロードプラグイン hexo-browsersync が原因で、公開には影響ありません。
解決方法:そのプラグインを無効にします。(公開に影響がないので、無視しても構いません)
-
何人かの大物のブログを引用して
- ToUNVRSe
- Yue_plus
- TTsdzb
- arkerny
- DarkLingYun
- Laurenfrost
- 安擎Angine
- 飞龙project
- sjfhsjfh
- Thexvoilone
- RyoJerryYu
- wmz1024
- madisontanle
- SherkeyXD
- soundofautumn
- LongFengShuanWu
- Zhongye1
- ChisatoNishikigi73
まずは nodejs と yarn をインストール。そして以下のコマンド通り:
yarn global add hexo-cli yo generator-hexo-theme
git clone -b hexo https://github.com/Yue-plus/hexo-theme-arknights.git
cd hexo-theme-arknights
git clone https://github.com/Yue-plus/hexo-theme-arknights.git themes/arknights
yarn install
hexo serve --debugこのテーマはお気に入れば:
- star 頂戴いたします
(/▽\)- star 100 達成したら、新しいテーマの開発をスケジュールに入れます。
- 新しいテーマ開発中:
- 開発者の arknight id:
24444750(中国 Bilibili 鯉) - Tencent QQ の交流グループ:618221514
- Reward:

