From 8ae446431de24d1d8f0615f4335f8cd5c6b7751a Mon Sep 17 00:00:00 2001 From: 简律纯 Date: Fri, 28 Jul 2023 13:56:52 +0800 Subject: feature: 添加起始页 MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/docs/API/index.md | 0 docs/docs/Core/index.md | 0 docs/docs/Standard/Structure/attribute.md | 0 docs/docs/Standard/Structure/class.md | 0 docs/docs/Standard/Structure/method.md | 0 docs/docs/Standard/Write/prepare.md | 0 docs/docs/Standard/Write/python.md | 0 docs/docs/Standard/Write/write.md | 0 docs/docs/Standard/details-about-rule-pack.md | 0 docs/docs/Standard/what-is-rule-pack.md | 13 +++ docs/docs/Standard/what-is-standard.md | 0 docs/docs/blog/index.md | 0 docs/docs/changelog/index.md | 0 docs/docs/index.md | 18 +---- docs/docs/showcase/index.md | 24 ------ docs/mkdocs.yml | 21 ++++- docs/overrides/assets/images/bg.jpg | Bin 0 -> 195735 bytes docs/overrides/assets/images/illustration.png | Bin 0 -> 197865 bytes docs/overrides/home.html | 111 ++++++++++++++++++++++++++ docs/requirements.txt | 4 +- 20 files changed, 149 insertions(+), 42 deletions(-) create mode 100644 docs/docs/API/index.md create mode 100644 docs/docs/Core/index.md create mode 100644 docs/docs/Standard/Structure/attribute.md create mode 100644 docs/docs/Standard/Structure/class.md create mode 100644 docs/docs/Standard/Structure/method.md create mode 100644 docs/docs/Standard/Write/prepare.md create mode 100644 docs/docs/Standard/Write/python.md create mode 100644 docs/docs/Standard/Write/write.md create mode 100644 docs/docs/Standard/details-about-rule-pack.md create mode 100644 docs/docs/Standard/what-is-rule-pack.md create mode 100644 docs/docs/Standard/what-is-standard.md delete mode 100644 docs/docs/blog/index.md delete mode 100644 docs/docs/changelog/index.md delete mode 100644 docs/docs/showcase/index.md create mode 100644 docs/overrides/assets/images/bg.jpg create mode 100644 docs/overrides/assets/images/illustration.png create mode 100644 docs/overrides/home.html diff --git a/docs/docs/API/index.md b/docs/docs/API/index.md new file mode 100644 index 00000000..e69de29b diff --git a/docs/docs/Core/index.md b/docs/docs/Core/index.md new file mode 100644 index 00000000..e69de29b diff --git a/docs/docs/Standard/Structure/attribute.md b/docs/docs/Standard/Structure/attribute.md new file mode 100644 index 00000000..e69de29b diff --git a/docs/docs/Standard/Structure/class.md b/docs/docs/Standard/Structure/class.md new file mode 100644 index 00000000..e69de29b diff --git a/docs/docs/Standard/Structure/method.md b/docs/docs/Standard/Structure/method.md new file mode 100644 index 00000000..e69de29b diff --git a/docs/docs/Standard/Write/prepare.md b/docs/docs/Standard/Write/prepare.md new file mode 100644 index 00000000..e69de29b diff --git a/docs/docs/Standard/Write/python.md b/docs/docs/Standard/Write/python.md new file mode 100644 index 00000000..e69de29b diff --git a/docs/docs/Standard/Write/write.md b/docs/docs/Standard/Write/write.md new file mode 100644 index 00000000..e69de29b diff --git a/docs/docs/Standard/details-about-rule-pack.md b/docs/docs/Standard/details-about-rule-pack.md new file mode 100644 index 00000000..e69de29b diff --git a/docs/docs/Standard/what-is-rule-pack.md b/docs/docs/Standard/what-is-rule-pack.md new file mode 100644 index 00000000..fc6aac35 --- /dev/null +++ b/docs/docs/Standard/what-is-rule-pack.md @@ -0,0 +1,13 @@ +--- +title: "什么是规则包？" +--- + + 规则包是水系核心用来加载的对象，可以理解为框架——水系核心加载的一个一个规则实例， + +现在回到规则包，我说规则包就是类似插件的设计，所以规则包也可以是一个Python文件或者一个Python包，但它必须基础一个像Plugin这样的类（不然无法读取，我们姑且叫这个类为Rule），以及在Rule的子类里实现一些像handle()或者rule()这样必须实现的方法（也叫函数），而这些必须实现的方法，就是我们要讨论的，一个通用规则包标准就是明确了一个继承自Rule类的子类它本身应该实现什么方法。 + +举个例子（随便写的，其中一些必须实现的属性或者类名都是不确定的，以后或许会改）： + +这样就实现了一个水系规则包，当pl使用.ra鉴定时会调用MyRule里的appriasal方法，如果鉴定结果数值小于5且大于0那么返回大成功。 + +我们要做的通用规则包标准就是这样一个“到底需要在Rule的子类MyRule里必须实现哪些方法？“的问题。 diff --git a/docs/docs/Standard/what-is-standard.md b/docs/docs/Standard/what-is-standard.md new file mode 100644 index 00000000..e69de29b diff --git a/docs/docs/blog/index.md b/docs/docs/blog/index.md deleted file mode 100644 index e69de29b..00000000 diff --git a/docs/docs/changelog/index.md b/docs/docs/changelog/index.md deleted file mode 100644 index e69de29b..00000000 diff --git a/docs/docs/index.md b/docs/docs/index.md index 1a2b40e4..cce47e7b 100644 --- a/docs/docs/index.md +++ b/docs/docs/index.md @@ -1,19 +1,5 @@ --- -hide: - - path - - navigation - - toc +template: home.html --- -
- -

HydroRollCore

- - HydroRollCore 是一个规则包读取与处理分发用工具，通过读取一个一个规则包实现水系骰子掷骰规则，同时支持模板创建与Wiki站点辅助设计规则书内容。
- 它是世界主入门水系的关键。 - -
- -

- 什么是规则包 -

+你好，世界主！ diff --git a/docs/docs/showcase/index.md b/docs/docs/showcase/index.md deleted file mode 100644 index f58ab2fe..00000000 --- a/docs/docs/showcase/index.md +++ /dev/null @@ -1,24 +0,0 @@ ---- -hide: - - navigation - - toc - - path ---- - -::gantt:: - -- title: Definition Phase - activities: - - title: Creative Brief - start: 2023-07-21 - end: 2023-08-21 - lasts: 1 months - - title: Graphic Design Research - start: 2023-08-22 - end: 2023-08-30 - lasts: 2 weeks - - title: Brainstorming / Mood Boarding - start: 2023-08-31 - end: 2023-12-20 - -::/gantt:: diff --git a/docs/mkdocs.yml b/docs/mkdocs.yml index 93c758d6..22891ec1 100644 --- a/docs/mkdocs.yml +++ b/docs/mkdocs.yml @@ -147,4 +147,23 @@ plugins: custom_format: "%d. %B %Y" # - git-committers: # repository: HydroRoll-Team/psi - # branch: main \ No newline at end of file + # branch: main + +nav: + - 主页: "index.md" + - 水系核心: + - "核心概览": Core/index.md + - 通用规则包标准: + - 什么是规则包?: Standard/what-is-rule-pack.md + - 为什么要做规则包?: Standard/why-rule-pack.md + - 什么是通用规则包标准?: Standard/what-is-standard.md + - 整体结构: + - "类": Standard/Structure/class.md + - "方法": Standard/Structure/method.md + - "属性": Standard/Structure/attribute.md + - 实战编写: + - "了解Python": Standard/Write/python.md + - "准备规则书": Standard/Write/prepare.md + - "编写规则包": Standard/Write/write.md + - API Reference: + - "API Reference": API/index.md \ No newline at end of file diff --git a/docs/overrides/assets/images/bg.jpg b/docs/overrides/assets/images/bg.jpg new file mode 100644 index 00000000..90976a9f Binary files /dev/null and b/docs/overrides/assets/images/bg.jpg differ diff --git a/docs/overrides/assets/images/illustration.png b/docs/overrides/assets/images/illustration.png new file mode 100644 index 00000000..69f739c0 Binary files /dev/null and b/docs/overrides/assets/images/illustration.png differ diff --git a/docs/overrides/home.html b/docs/overrides/home.html new file mode 100644 index 00000000..79b18ba8 --- /dev/null +++ b/docs/overrides/home.html @@ -0,0 +1,111 @@ + + +{% extends "main.html" %} + + +{% block tabs %} + {{ super() }} + + + + + +
+
+
+ + +
+ +
+ + +
+

HydroRollCore

+ HydroRollCore 是一个规则包读取与处理分发用工具，通过读取一个一个规则包实现水系骰子掷骰规则，同时支持模板创建与Wiki站点辅助设计规则书内容。
+ 它是世界主入门水系的关键。
+ + 快速开始 + + + 了解通用规则包标准 + +
+
+
+
+{% endblock %} + + +{% block content %} + +{% endblock %} + + +{% block footer %} + +{% endblock %} \ No newline at end of file diff --git a/docs/requirements.txt b/docs/requirements.txt index 363e9c69..d57171f6 100644 --- a/docs/requirements.txt +++ b/docs/requirements.txt @@ -3,4 +3,6 @@ mkdocs-blog-plugin mkdocs-git-revision-date-localized-plugin mkdocs-git-authors-plugin mkdocs-material-extensions>=1.1 -neoteroi-mkdocs \ No newline at end of file +neoteroi-mkdocs +pillow +cairosvg \ No newline at end of file -- cgit v1.2.3-70-g09d2