Хексо-тема-аркнайтс
Если вы используете эту тему, мы будем признательны, если вы разместите здесь свою ссылку для предварительного просмотра!
hexo init Hexo
cd Hexo
npm install
git clone https://github.com/Yue-plus/hexo-theme-arknights.git themes/arknights
Для пользователей npm:
npm install hexo-server hexo-browsersync hexo-renderer-pug --save
Для пользователей yarn:
yarn add hexo-server hexo-browsersync hexo-renderer-pug
Отредактируйте файл _config.yml
в папке Hexo/
. Вы можете обратиться к документации Hexo (https://hexo.io/docs/configuration).
Измените значение по умолчанию для theme:
с landscape
на arknights
.
Включите подсветку кода:
highlight:
hljs: true
Переместите файл Hexo/themes/arknights/_config.yml
в корневой каталог Hexo и переименуйте его в _config.arknights.yml
.
Пожалуйста, обратитесь к разделу «Альтернативная конфигурация темы» (https://hexo.io/docs/configuration#Alternate-Theme-Config).
Конфигурационный файл темы можно изменить, обратившись к китайским комментариям.
Следующие файлы можно добавить в каталог Hexo/source
:
Вы можете изменить содержимое каталога Hexo/themes/arknights/source/
по своему усмотрению:
Обратитесь к разделу Hexo | Writing (https://hexo.io/docs/writing).
Некоторые примеры текстов доступны в ветке Hexo.
Чтобы добавить теги и категории или получить доступ к дополнительным функциям, обратитесь к разделу Hexo | Front-matter (https://hexo.io/docs/front-matter). Пример:
---
title: 'Hello World !'
date: 2020-04-15 21:54:02
tags: code
category: Example
---
Содержимое перед <!-- more -->
называется резюме. Оно будет отображаться на домашней странице, и вы можете настроить, будет ли оно также отображаться в основном тексте статьи.
Пример: создание страницы about
hexo new page 'about'
в каталоге Hexo.Hexo/source/
.Отредактируйте файл 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: page
Измените per_page:
на 0.
Тема поддерживает Valine (https://valine.js.org/en/index.html).
Пожалуйста, обратитесь к Valine Quick Start (https://valine.js.org/en/quickstart.html) и отредактируйте _config.arknights.yml
в вашем каталоге Hexo:
valine:
enable: false
app_id: # APP ID
app_key: # APP KEY
server_url: # APP DOMAIN (LeanCloud international version requires this)
``` **Уведомления с электронной почтой: zhaojun1998 / Valine-Admin**
> **Примечание!** `server_url:` требуется только при использовании международной версии LeanCloud.
> Этот параметр можно найти в приложении LeanCloud в разделе «Настройки» → «Учетные данные приложения» → «Белый список доменов» → «Запрос домена» для имени домена, заканчивающегося на .api.lncldglobal.com, и добавить префикс «https:».
### Gitalk
Тема поддерживает [Gitalk](https://gitalk.github.io/). Пожалуйста, обратитесь к [gitalk/readme.md](https://github.com/gitalk/gitalk/blob/master/readme.md) и отредактируйте `_config.arknights.yml` в каталоге Hexo:
```yaml
gitalk:
enable: false
client_id: # Идентификатор клиента GitHub Application
client_secret: # Секрет клиента GitHub Application
repo: # Репозиторий GitHub
owner: # Владелец репозитория GitHub
admin: [] # Администратор репозитория (Пользователи, имеющие доступ на запись к этому репозиторию).
# Пример: [adminA, adminB]
id: # Уникальный идентификатор страницы
# Пример: location.pathname
Тема поддерживает Waline.
Пожалуйста, обратитесь к документации Waline docs и отредактируйте _config.arknights.yml
в вашем каталоге Hexo.
waline:
enable: false
server_url: #Server_Url
Тема поддерживает Artalk.
Пожалуйста, обратитесь к документации Artalk и отредактируйте _config.arknights.yml
в своём каталоге Hexo.
artalk:
enable: false
server: https://artalk.server.instance/ # 你的 Artalk 服务地址
site_name: My Blog # 站点名称,用于区分多个站点(可选)
В теме поддерживаются два сценария отображения математических формул:
Вы можете использовать фильтр hexo-filter-mathjax, чтобы статически отображать математические формулы:
Рекомендуется сначала заменить средство рендеринга Markdown 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 # используйте одиночный '$' в качестве разделителя математических формул
cjk_width: 0.9 # Относительная ширина символов CJK
normal_width: 0.6 # Относительная нормальная ширина
append_css: true # Добавить CSS на каждую страницу
every_page: false # Если верно, то каждая страница будет отображаться с помощью mathjax, независимо от настройки `mathjax` во вступительной части каждой статьи
Добавьте mathjax: true
во вступительную часть статьи, которая требует включения mathjax:
---
title: Об электродинамике движущихся тел
categories: Физика
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 по умолчанию, и замените его на hexo-renderer-kramed с лучшей поддержкой MathJax:
npm uninstall hexo-renderer-marked --save
npm install hexo-renderer-kramed --save
Отредактируйте _config.arknights.yml
в своем каталоге Hexo:
# Поддержка формул
mathjax:
- enable: false
```latex
% Single-line inline formula
% Note that you need to put "`" on both sides, and there can be no space between "`" and "$"
`$\sigma$`
% Multi-line formula
$$
\begin{aligned}f(x) &= \sum_{i=1}^{\infty}{\frac{x}{2^i}} \\
&= x\end{aligned}
$$
\epsilon_0
\begin{eqnarray*}
Плагин hexo-renderer-kramed имеет другие настраиваемые элементы, пожалуйста, обратитесь к документации плагина: https://github.com/sun11/hexo-renderer-kramed.
Преимущества и недостатки этих схем отображения формул:
Отредактируйте _config.arknights.yml
в вашем каталоге Hexo:
# Поддержка диаграмм
mermaid:
- enable: false
+ enable: true
version: '8.13.5'
Тема отображает различные диаграммы с помощью mermaid-js. Примеры.
Поддерживает: Flow Chart | Sequence Diagram | Class Diagram | State Diagram | Entity Relationship Diagram | User Journey Map | Gantt Chart | Instruction Map | Pie Chart
Синтаксис:
<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 --save
Для пользователей yarn:
yarn add hexo-wordcount
Затем отредактируйте _config.arknights.yml
в каталоге Hexo:
post:
count: true # Отображение количества слов
time: true # Статистика времени чтения
Используйте 不蒜子 для статистики просмотров страниц.
Измените файл _config.arknights.yml
в каталоге Hexo, чтобы включить эту функцию:
busuanzi:
enable: false
sitePV: true # Общее количество посещений сайта
siteUV: true # Количество посетителей сайта
pagePV: true # Просмотры страниц
Модифицированный плагин hexo-blog-encrypt был адаптирован и интегрирован в эту тему (в настоящее время поддерживаются только темы по умолчанию и up).
Для подробной конфигурации обратитесь к hexo-blog-encrypt.
Добавьте следующее в файл Hexo/_config.yml
:
# Безопасность
encrypt: # hexo-blog-encrypt
abstract: Password required for weak neural connection to **Rhodes Island™**
message: Пожалуйста, введите пароль для слабого нейронного соединения с Rhodes Island™.
tags:
- {name: tagName, password: PassowrdA}
- {name: tagName, password: PasswordB}
wrong_pass_message: Не удалось проверить пароль с помощью Rhodes Island™, пожалуйста, попробуйте ещё раз.
wrong_hash_message: Не удалось подтвердить пароль с помощью Rhodes Island™, в данный момент вы просматриваете страницу с временными привилегиями.
**Или**
Установите следующее в [Front-matter](https://hexo.io/docs/front-matter) статьи:
```markdown
---
title: Hello World
tags:
— Encrypted as a diary
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
В дополнение к Front-matter, поддерживаемому Hexo, тема также поддерживает:
# Дата публикации/обновления в правом верхнем углу страницы статьи
post-info: true/false
# Боковая панель оглавления
post-index: true/false
# Награды
reward: true/false
Вы можете поместить свои собственные фрагменты CSS в Hexo/source/css/
;
поместите файл JavaScript в Hexo/source/js/
;
Затем отредактируйте Hexo/_config.arknights.yml
:
# Включить таблицы стилей CSS внутри тегов `<head>`
stylesheets:
— //unpkg.com/@highlightjs/cdn-assets@11.4.0/styles/atom-one-dark-reasonable.min.css
+ — /css/custom.css
# Ввести JavaScript в конце `<body>`
scripts:
— //unpkg.com/@highlightjs/cdn-assets@11.4.0/highlight.min.js
+ — /js/custom.js
Папка ресурсов — это место, где пользователь хранит свои ресурсы.
За исключением папки_posts
, файлы/папки и скрытые файлы, начинающиеся с_
(подчёркивание), будут игнорироваться.
Файлы Markdown и HTML будут проанализированы и помещены в папкуpublic
, а другие файлы скопированы туда же.
Добро пожаловать, чтобы отправить Issues и PR.
Ветвь | Иллюстрация |
---|---|
main | Относительно стабильная версия |
gh-pages | Хостинг gh-страниц |
hexo | Каталог Hexo, здесь вы можете найти файлы .md для тестирования вашей темы |
TypeScript необходимо компилировать вручную, пожалуйста, установите typescript
глобально и выполните команду tsc
в каталоге arknights\source\js\_src
, чтобы скомпилировать его.
Это вызвано hexo-browsersync
, и не повлияет на выпуск.
Обходной путь: Отключите плагин. (В любом случае, это не влияет на релиз, независимо от того, что вы делаете)
Также процитируйте несколько крупных блогов
Вы можете оставить комментарий после Вход в систему
Неприемлемый контент может быть отображен здесь и не будет показан на странице. Вы можете проверить и изменить его с помощью соответствующей функции редактирования.
Если вы подтверждаете, что содержание не содержит непристойной лексики/перенаправления на рекламу/насилия/вульгарной порнографии/нарушений/пиратства/ложного/незначительного или незаконного контента, связанного с национальными законами и предписаниями, вы можете нажать «Отправить» для подачи апелляции, и мы обработаем ее как можно скорее.
Опубликовать ( 0 )