1 В избранное 0 Ответвления 0

OSCHINA-MIRROR/yue_plus-hexo-theme-arknights

Присоединиться к Gitlife
Откройте для себя и примите участие в публичных проектах с открытым исходным кодом с участием более 10 миллионов разработчиков. Приватные репозитории также полностью бесплатны :)
Присоединиться бесплатно
Клонировать/Скачать
Внести вклад в разработку кода
Синхронизировать код
Отмена
Подсказка: Поскольку Git не поддерживает пустые директории, создание директории приведёт к созданию пустого файла .keep.
Loading...
README.en.md

Хексо-тема-аркнайтс

Preview

Если вы используете эту тему, мы будем признательны, если вы разместите здесь свою ссылку для предварительного просмотра!

Preview image

Установка

Системные требования

Создание нового проекта блога с помощью hexo-cli

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:

  • CNAME: Пользовательский домен при развёртывании GitHub Pages.
  • Файлы Alipay.png и WeChat.png в каталоге img/ — это ваши собственные QR-коды (изображения в формате png с разрешением 1:1).

Вы можете изменить содержимое каталога Hexo/themes/arknights/source/ по своему усмотрению:

  • favicon.ico: Значки на вкладках браузера (64 * 64, не отображаются при высоком разрешении).
  • README.md: README для репозитория развёртывания.

Написание статей

  • Обратитесь к разделу 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 создаст папку about в 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

Тема поддерживает 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.
Пожалуйста, обратитесь к документации Waline docs и отредактируйте _config.arknights.yml в вашем каталоге Hexo.

waline:
  enable: false 
  server_url: #Server_Url

Artalk

Тема поддерживает Artalk.
Пожалуйста, обратитесь к документации Artalk и отредактируйте _config.arknights.yml в своём каталоге Hexo.

artalk:
  enable: false
  server: https://artalk.server.instance/ # 你的 Artalk 服务地址
  site_name: My Blog # 站点名称,用于区分多个站点(可选)

Математические формулы

В теме поддерживаются два сценария отображения математических формул:

Вариант 1: Статическое отображение

Вы можете использовать фильтр hexo-filter-mathjax, чтобы статически отображать математические формулы:

Рекомендуется сначала заменить средство рендеринга Markdown hexo-renderer-pandoc, которое лучше обрабатывает математические формулы.

  1. Выполните следующие команды в каталоге Hexo:

    # Установите hexo-filter-mathjax
    cnpm install hexo-filter-mathjax --save
    # Очистите кэш
    hexo clean
  2. Добавьте следующее в 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` во вступительной части каждой статьи
  3. Добавьте mathjax: true во вступительную часть статьи, которая требует включения mathjax:

    ---
    title: Об электродинамике движущихся тел
    categories: Физика
    date: 1905-06-30 12:00:00
    mathjax: true
    ---

    После этого вы можете использовать LaTeX в своих статьях.

  4. Обратите внимание, что встроенные математические формулы (… $<математическая формула>$ ...) не могут иметь пробелов после открывающего $ и перед закрывающим $! Например:

    - $ \epsilon_0 $
    + $\epsilon_0$
    - $ \frac{\partial}{\partial t} $
    + $\frac{\partial}{\partial t}$
  5. Помните о конфликте между синтаксисом LaTeX и Markdown. При необходимости используйте \ для экранирования:

    - $\epsilon_0$
    + $\epsilon\_0$
    - \begin{eqnarray*}
    + \begin{eqnarray\*}

Вариант 2: Динамическое отображение

Тема также поддерживает MathJax, чтобы динамически отображать формулы по мере просмотра пользователем:

  1. Сначала удалите средство рендеринга hexo-renderer-marked, которое поставляется с Hexo по умолчанию, и замените его на hexo-renderer-kramed с лучшей поддержкой MathJax:

    npm uninstall hexo-renderer-marked --save
    npm install hexo-renderer-kramed --save
  2. Отредактируйте _config.arknights.yml в своем каталоге Hexo:

      # Поддержка формул
      mathjax:
    -   enable: false  
  • enable: true
    version: '2.6.1' # important

```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}  
$$  
  1. С этой схемой не будет конфликта между синтаксисом LaTeX и Markdown. Для использования синтаксиса LaTeX в тексте экранирование не требуется. Можно без проблем использовать следующие формулы:
\epsilon_0
\begin{eqnarray*}

Плагин hexo-renderer-kramed имеет другие настраиваемые элементы, пожалуйста, обратитесь к документации плагина: https://github.com/sun11/hexo-renderer-kramed.

Преимущества и недостатки этих схем отображения формул:

  1. Динамическое отображение не требует экранирования и может лучше поддерживать файлы Markdown, экспортированные из других мест. Но поскольку оно должно отображаться в браузере, отображение страницы будет немного задерживаться.
  2. Статическое отображение компилирует формулу непосредственно в статический файл, что обеспечивает лучшую производительность отображения, но синтаксис должен быть экранирован.
  3. hexo-renderer-pandoc быстро отображает формулы без необходимости экранировать синтаксис, но требует установки Pandoc.

Поддержка диаграмм

Отредактируйте _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

В дополнение к Front-matter, поддерживаемому Hexo, тема также поддерживает:

# Дата публикации/обновления в правом верхнем углу страницы статьи
post-info: true/false

# Боковая панель оглавления
post-index: true/false

# Награды
reward: true/false

Импорт пользовательских файлов CSS/JS

Вы можете поместить свои собственные фрагменты 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, а другие файлы скопированы туда же.

— Из официальной документации Hexo

Участие в разработке

Добро пожаловать, чтобы отправить Issues и PR.

Описание ветки

Ветвь Иллюстрация
main Относительно стабильная версия
gh-pages Хостинг gh-страниц
hexo Каталог Hexo, здесь вы можете найти файлы .md для тестирования вашей темы

Ошибки и решения, которые могут возникнуть во время разработки

Модифицированный файл TS не вступает в силу

TypeScript необходимо компилировать вручную, пожалуйста, установите typescript глобально и выполните команду tsc в каталоге arknights\source\js\_src, чтобы скомпилировать его.

Длинные статьи не полностью отображаются при запуске 'hexo serve --debug'

Это вызвано hexo-browsersync, и не повлияет на выпуск.

Обходной путь: Отключите плагин. (В любом случае, это не влияет на релиз, независимо от того, что вы делаете)

Документация, которая может потребоваться для участия в разработке

Разработчики

Комментарии ( 0 )

Вы можете оставить комментарий после Вход в систему

Введение

Описание недоступно Развернуть Свернуть
JavaScript и 6 других языков
MIT
Отмена

Обновления

Пока нет обновлений

Участники

все

Недавние действия

Загрузить больше
Больше нет результатов для загрузки
1
https://api.gitlife.ru/oschina-mirror/yue_plus-hexo-theme-arknights.git
git@api.gitlife.ru:oschina-mirror/yue_plus-hexo-theme-arknights.git
oschina-mirror
yue_plus-hexo-theme-arknights
yue_plus-hexo-theme-arknights
main