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

OSCHINA-MIRROR/yue_plus-hexo-theme-arknights

Присоединиться к Gitlife
Откройте для себя и примите участие в публичных проектах с открытым исходным кодом с участием более 10 миллионов разработчиков. Приватные репозитории также полностью бесплатны :)
Присоединиться бесплатно
Клонировать/Скачать
README.ja.md 14 КБ
Копировать Редактировать Web IDE Исходные данные Просмотреть построчно История
gitlife-traslator Отправлено 26.11.2024 18:40 b3715b0

hexo-theme-arknights

デモページ

Этот блог использует тему hexo-theme-arknights, если вы хотите добавить ссылку на свой блог, добро пожаловать!

Тема демо-страницы

Установка

Среда

С помощью 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

Изменение файлов конфигурации

  • Обратитесь к официальному сайту Hexo (https://hexo.io/ja/docs/configuration.html) и измените файл _config.yml в каталоге Hexo.

    • Измените значение theme: с landscape на arknights.

    • Включите подсветку кода:

      highlight:
        hljs: true
  • Переместите файл _config.arknights.yml из каталога Hexo/themes/arknights в каталог Hexo, переименуйте его в _config.arknights.yml.

    Для справки:

    Вы можете изменить файл конфигурации темы, используя комментарии на китайском языке в качестве руководства.

Изменение файлов ресурсов

При необходимости добавьте следующие файлы в каталог Hexo/source/:

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

При необходимости измените следующие файлы в каталоге Hexo/themes/arknights/source/:

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

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

  • См. раздел «Написание» на сайте Hexo (https://hexo.io/ja/docs/writing.html).

  • В ветке Hexo репозитория темы есть несколько примеров текстов (https://github.com/Yue-plus/hexo-theme-arknights/tree/hexo/source/_posts).

  • Добавьте теги и категории к статьям, чтобы получить больше функций. Вы можете обратиться к разделу «Front-matter» на сайте Hexo для получения дополнительной информации (https://hexo.io/ja/docs/front-matter.html), например:

    ---
    title: 'Hello World !'
    date: 2020-04-15 21:54:02
    tags: code
    category: Example
    ---
  • Содержимое перед <!-- more --> называется кратким содержанием, оно отображается на домашней странице и может быть отображено в основной статье.

Добавление страниц в навигационную панель

Например, создайте новую страницу about:

  • Выполните команду hexo new page 'about' в каталоге Hexo.
  • Затем в каталоге Hexo/source/ будет создана папка about.
  • Отредактируйте файл Hexo/source/about/index.md.

  • Измените файл _config.arknights.yml, добавив ссылку:

    menu:
      About: /about

Запрет постраничной навигации

Эта настройка находится примерно на 88-й строке файла конфигурации Hexo _config.yml.

# Pagination
## Set per_page to 0 to disable pagination
per_page: 10
pagination_dir: page

Просто установите per_page: равным 0.

Система комментариев

Valine

Эта тема поддерживает Valine. Следуя быстрому старту Valine, измените файл конфигурации Hexo _config.arknights.yml:

valine:
  enable: false
  app_id: # APP ID
  app_key: # APP KEY
  server_url: # APP DOMAIN(LeanCloud 国际版)

Включите уведомления по электронной почте: zhaojun1998 / Valine-Admin

Внимание! Valine можно использовать только с LeanCloud International Edition, необходимо установить server_url: . Эту настройку можно найти в приложении LeanCloud > настройки > приложение сертификата > белый список доменов > Request домена и добавить префикс https://.

Gitalk

Эта тема также поддерживает 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. Структура:

<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 интегрирован в эту тему (в настоящее время поддерживается только для тем default и up).

Подробные инструкции по настройке см. в 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: Не удалось активировать пароль. Пожалуйста, попробуйте ещё раз.
  wrong_hash_message: Произошла ошибка с действующим паролем. В данный момент отображается временно разрешённый доступ.

Или используйте настройки в секции Front-matter статьи:

---
title: Hello World
tags:
- Зашифровано как дневник
date: 2016-03-30 21:12:21
password: mikemessi
abstract:Для получения доступа к слабонервным соединениям с Rhodes Island требуется пароль.
message:Пожалуйста, введите пароль для подключения к Rhodes Island™:
wrong_pass_message:Не удалось активировать пароль. Пожалуйста, попробуйте ещё раз.
wrong_hash_message:Произошла ошибка с действующим паролем. В данный момент отображается временно разрешённый доступ.
---

Поиск

Поиск включён по умолчанию. Чтобы отключить его, следуйте инструкциям в файле 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:
+ - /css/custom.css
  
  # Вставить скрипт JavaScript в конец тега `<body>`
  scripts:
+ - /js/custom.js

Ресурсная папка предназначена для хранения пользовательских ресурсов. Файлы и папки, начинающиеся с символа подчёркивания (_), а также скрытые файлы, кроме тех, что находятся в папке _posts, игнорируются. Markdown и HTML файлы анализируются и помещаются в папку public, а остальные файлы копируются.

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

Внесите свой вклад в разработку темы

Мы будем рады видеть ваши усилия!

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

Ветка Описание
main Относительно стабильная версия
gh-pages Страница на GitHub
hexo Файлы Hexo и тестовые файлы .md

Проблемы, с которыми можно столкнуться во время разработки

Изменения в файлах TS не отражаются

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

При выполнении команды hexo serve --debug длинные статьи не отображаются полностью

Это связано с плагином горячего рефреша hexo-browsersync, но это не влияет на публикацию.

Решение: Отключите этот плагин. (Поскольку это не влияет на публикацию, вы можете проигнорировать эту проблему.)

Документы, необходимые для участия в разработке

Опубликовать ( 0 )

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

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