Bladeren bron

用户指南编纂 #20

Bhikkhu-Kosalla 5 jaren geleden
bovenliggende
commit
feb5df0f29

+ 17 - 2
app/guide/guide.css

@@ -15,6 +15,14 @@ guide{
 guide:hover  .guide_contence{
     display:inline-block;
 }
+guide ul{
+    list-style-type:disc;
+    padding-left:20px;
+}
+guide ol{
+    list-style-type:decimal;
+    padding-left:20px;
+}
 .guide_contence {
     border-top: 7px;
     position: absolute;
@@ -23,13 +31,21 @@ guide:hover  .guide_contence{
     top:100%;
     width: max-content;
     min-width:18em;
+    max-width: calc(30vw);
     min-height:15em;
     padding:10px;
-    background-color: var(--tool-bg-color);
+    background-color: var(--drop-bg-color);
     box-shadow: 0 0 10px rgba(0,0,0,0.15);
     font-size:10pt;
     text-align:left;
     display:none;
+
+    margin: 0.3em;
+    margin: -1px 0px;
+    box-shadow: 0px 3px 13px 0px var(--shadow-color);
+    color: var(--main-color);
+    z-index: 200;
+    padding: 0 0.2em;
 }
 /*
 .guide_contence:after {
@@ -62,7 +78,6 @@ guide:hover  .guide_contence{
     font-weight:700;
 }
 .guide_contence  li{
-    display: block;
     white-space: unset;
     word-break: normal;
 }

+ 6 - 6
app/studio/editor.php

@@ -599,7 +599,7 @@ foreach($plugin_list as $info){
 				</div>
 				<!-- 拆分 -->
 				<div class="edit_detail_p">
-					<guide gid="break_down"></guide>
+					<guide gid="studio_break_down"></guide>
 					<span class="edit_detail_span"><?php echo $_local->gui->part;?>:</span>
 					<input type="text" id="input_org" class="input_bar" value="" name="in_org" onkeydown="match_key(this)" onkeyup="unicode_key(this) " onchange="input_org_change()">
 					<div class="case_dropdown">
@@ -612,7 +612,7 @@ foreach($plugin_list as $info){
 				</div>
 				<!-- 拆分意思 -->
 				<div class="edit_detail_p" >
-					<guide gid="part_meaning"></guide>
+					<guide gid="studio_part_meaning"></guide>
 					<span class="edit_detail_span"><?php echo $_local->gui->partmeaning;?>:</span>
 					<div id="input_org_select" class="input_bar" style="width:80%; display:inline-flex;"></div>
 					<input type="text" id="input_om" class="input_bar" value="" name="in_om" onblur="input_org_switch('input_om','input_org_select')">
@@ -680,14 +680,14 @@ foreach($plugin_list as $info){
 				</div>
 				<!-- 词源 -->
 				<div id="edit_detail_prt_prt" class="edit_detail_p" style="display:none;">
-				<guide gid="studio_parent"></guide>
+				<guide gid="studio_parent2"></guide>
 					<div class="case_dropdown" style="padding-left: 2em;width: 6em;display: flex;">
 						<span style="padding-right: 4px;">┕</span>
 						<span id="parent_grammar">.ppa.</span>
 						<div id="word_mdf_prt_prt_grammar_dropdown" class="case_dropdown-content">
-							<a onclick="edit_parent_grammar_changed(this)">pp.</a>
-							<a onclick="edit_parent_grammar_changed(this)">pr.p.</a>				
-							<a onclick="edit_parent_grammar_changed(this)">fpp.</a>
+							<a onclick="edit_parent_grammar_changed(this)">.pp.</a>
+							<a onclick="edit_parent_grammar_changed(this)">.prp.</a>				
+							<a onclick="edit_parent_grammar_changed(this)">.fpp.</a>
 						</div>
 					</div>
 					<input type="text" id="id_text_prt_prt" class="input_bar" onkeydown="match_key(this)" onkeyup="unicode_key(this)" />

+ 15 - 0
documents/users_guide/zh-cn/grammar_abbr.md

@@ -1,3 +1,18 @@
+## 基本操作
+- 通过下拉菜单选择填入语法信息
+- 首先选定类型——带外框的,比如:动词
+- 然后选择后续的内容,比如:三 单 现
+- 以上涉及的**语法缩略语**可以参照下面的表格
+- 调整**语法信息**和**虚词公式**,列举这个词可能的含义
+
+## 连读词拆分
+连读词拆分使用教程 (暂缺)
+
+## 复合词拆分
+复合词拆分使用教程(文本暂缺)
+- [YouTube](https://youtu.be/iN1t0Rq9aKk)  
+- [百度网盘](https://pan.baidu.com/s/1nXZG2GQkkkfblNnshDuS_w)  提取码:pali 
+
 ## 语法缩略语表
 | 缩略语   | 英文缩写  | 备注                         |
 | :------- | :-------- | :--------------------------- |

+ 15 - 0
documents/users_guide/zh-cn/studio_break_down.md

@@ -0,0 +1,15 @@
+## 拆分信息
+巴利语拆分是从词源入手进行语义解析的重要手段。
+
+用户可以根据自己的意愿决定把单词拆到什么程度。
+
+如果用加号“+”分隔每个组分,机器会自动识别并查询相应的组分。
+
+如果是连读词(sandhi)是可以进行进一步拆解和分别分析的。
+
+如果不清楚如何拆分,有几种渠道可供选择:
+- 点词查询
+  - 点击某个单词,点开右上角的<svg id="icon_dict" viewBox="0 0 32 32" style='fill:#6baaff;height: 10px; width: 15px;'><g transform="translate(-4 -4)"><path class="a" d="M24.4,2,17.9,7.85v14.3l6.5-5.85V2M8.15,5.9A12.09,12.09,0,0,0,1,7.85V26.908a.7.7,0,0,0,.65.65c.13,0,.195-.091.325-.091A15.85,15.85,0,0,1,8.15,26.05,12.09,12.09,0,0,1,15.3,28a15.659,15.659,0,0,1,7.15-1.95,13.241,13.241,0,0,1,6.175,1.378.565.565,0,0,0,.325.039.7.7,0,0,0,.65-.65V7.85A8.867,8.867,0,0,0,27,6.55V24.1a15.106,15.106,0,0,0-4.55-.65A15.659,15.659,0,0,0,15.3,25.4V7.85A12.09,12.09,0,0,0,8.15,5.9Z" transform="translate(5 4)"></path></g></svg>中会显示词典查询结果。
+  - 很多长词在巴缅词典(共三本)中能找到拆分结果
+- **强力拆分**功能
+- 询问老师

+ 9 - 0
documents/users_guide/zh-cn/studio_case_fomular.md

@@ -0,0 +1,9 @@
+### 虚词公式
+- 我们在本行的
+<span><svg viewBox='0 0 24 24' id='ic_more' style='fill:#6baaff;height: 10px; width: 15px;'><path d='M22 3H7c-.69 0-1.23.35-1.59.88L0 12l5.41 8.11c.36.53.97.89 1.66.89H22c1.1 0 2-.9 2-2V5c0-1.1-.9-2-2-2zM9 13.5c-.83 0-1.5-.67-1.5-1.5s.67-1.5 1.5-1.5 1.5.67 1.5 1.5-.67 1.5-1.5 1.5zm5 0c-.83 0-1.5-.67-1.5-1.5s.67-1.5 1.5-1.5 1.5.67 1.5 1.5-.67 1.5-1.5 1.5zm5 0c-.83 0-1.5-.67-1.5-1.5s.67-1.5 1.5-1.5 1.5.67 1.5 1.5-.67 1.5-1.5 1.5z'></path></svg></span>
+    中列举了与该**语法信息**相应的虚词公式
+- 如果对自动套用的虚词公式不满意,可用从<span><svg viewBox='0 0 24 24' id='ic_more' style='fill:#6baaff;height: 10px; width: 15px;'><path d='M22 3H7c-.69 0-1.23.35-1.59.88L0 12l5.41 8.11c.36.53.97.89 1.66.89H22c1.1 0 2-.9 2-2V5c0-1.1-.9-2-2-2zM9 13.5c-.83 0-1.5-.67-1.5-1.5s.67-1.5 1.5-1.5 1.5.67 1.5 1.5-.67 1.5-1.5 1.5zm5 0c-.83 0-1.5-.67-1.5-1.5s.67-1.5 1.5-1.5 1.5.67 1.5 1.5-.67 1.5-1.5 1.5zm5 0c-.83 0-1.5-.67-1.5-1.5s.67-1.5 1.5-1.5 1.5.67 1.5 1.5-.67 1.5-1.5 1.5z'></path></svg></span>中选择。
+- 自动给出的公式显示为<span style='color:#BD8B18;'>金黄色</span>,且该公式不会进入[个人单词本](./setting.php?item=userdict)
+- 手动选择的公式显示为<span style='color:#f9468f;'>粉红色</span>,且该公式会进入[个人单词本](./setting.php?item=userdict)
+- 通过**虚词公式**可以加深我们对语法概念的理解
+- 初学者也可以透过调整**语法信息**和**虚词公式**来实现**格位**、**变位**的抉择

+ 3 - 10
documents/users_guide/zh-cn/studio_general_meaning.md

@@ -5,18 +5,11 @@
 - 点开右上角的<svg id="icon_dict" viewBox="0 0 32 32" style='fill:#6baaff;height: 10px; width: 15px;'><g transform="translate(-4 -4)"><path class="a" d="M24.4,2,17.9,7.85v14.3l6.5-5.85V2M8.15,5.9A12.09,12.09,0,0,0,1,7.85V26.908a.7.7,0,0,0,.65.65c.13,0,.195-.091.325-.091A15.85,15.85,0,0,1,8.15,26.05,12.09,12.09,0,0,1,15.3,28a15.659,15.659,0,0,1,7.15-1.95,13.241,13.241,0,0,1,6.175,1.378.565.565,0,0,0,.325.039.7.7,0,0,0,.65-.65V7.85A8.867,8.867,0,0,0,27,6.55V24.1a15.106,15.106,0,0,0-4.55-.65A15.659,15.659,0,0,0,15.3,25.4V7.85A12.09,12.09,0,0,0,8.15,5.9Z" transform="translate(5 4)"></path></g></svg>中
 - 右侧边栏会显示词典查询结果
 
-### 虚词公式
-- 我们在
-<span><svg viewBox='0 0 24 24' id='ic_more' style='fill:#6baaff;height: 10px; width: 15px;'><path d='M22 3H7c-.69 0-1.23.35-1.59.88L0 12l5.41 8.11c.36.53.97.89 1.66.89H22c1.1 0 2-.9 2-2V5c0-1.1-.9-2-2-2zM9 13.5c-.83 0-1.5-.67-1.5-1.5s.67-1.5 1.5-1.5 1.5.67 1.5 1.5-.67 1.5-1.5 1.5zm5 0c-.83 0-1.5-.67-1.5-1.5s.67-1.5 1.5-1.5 1.5.67 1.5 1.5-.67 1.5-1.5 1.5zm5 0c-.83 0-1.5-.67-1.5-1.5s.67-1.5 1.5-1.5 1.5.67 1.5 1.5-.67 1.5-1.5 1.5z'></path></svg></span>
-    中列举了与该**语法信息**相应的虚词公式
-- 如果对自动套用的虚词公式不满意,可用从<span><svg viewBox='0 0 24 24' id='ic_more' style='fill:#6baaff;height: 10px; width: 15px;'><path d='M22 3H7c-.69 0-1.23.35-1.59.88L0 12l5.41 8.11c.36.53.97.89 1.66.89H22c1.1 0 2-.9 2-2V5c0-1.1-.9-2-2-2zM9 13.5c-.83 0-1.5-.67-1.5-1.5s.67-1.5 1.5-1.5 1.5.67 1.5 1.5-.67 1.5-1.5 1.5zm5 0c-.83 0-1.5-.67-1.5-1.5s.67-1.5 1.5-1.5 1.5.67 1.5 1.5-.67 1.5-1.5 1.5zm5 0c-.83 0-1.5-.67-1.5-1.5s.67-1.5 1.5-1.5 1.5.67 1.5 1.5-.67 1.5-1.5 1.5z'></path></svg></span>中选择。
-- 自动给出的公式显示为<span style='color:#BD8B18;'>金黄色</span>
-- 手动选择的公式显示为<span style='color:#f9468f;'>粉红色</span>
-- 通过**虚词公式**可以加深我们对语法概念的理解
-- 初学者也可以透过调整**语法信息**和**虚词公式**来实现**格位**、**变位**的抉择
+在本行末端的<span><svg viewBox='0 0 24 24' id='ic_more' style='fill:#6baaff;height: 10px; width: 15px;'><path d='M22 3H7c-.69 0-1.23.35-1.59.88L0 12l5.41 8.11c.36.53.97.89 1.66.89H22c1.1 0 2-.9 2-2V5c0-1.1-.9-2-2-2zM9 13.5c-.83 0-1.5-.67-1.5-1.5s.67-1.5 1.5-1.5 1.5.67 1.5 1.5-.67 1.5-1.5 1.5zm5 0c-.83 0-1.5-.67-1.5-1.5s.67-1.5 1.5-1.5 1.5.67 1.5 1.5-.67 1.5-1.5 1.5zm5 0c-.83 0-1.5-.67-1.5-1.5s.67-1.5 1.5-1.5 1.5.67 1.5 1.5-.67 1.5-1.5 1.5z'></path></svg></span>可以显示系统匹配的含义列表,通过点选实现快捷输入
+
 
 註:
-- 此处的设计是为翻译者追求信达雅中的**达**提供发挥空间,即优先追求表意的明确性
+- 此处的设计是针对**信达雅**三大翻译指标中的**达**,即优先追求含义表达的明确性
 - 对于词源学我们设计了**拆分方式**与**拆分含义**
 - 文学优美性我们提供了**整体译文**
 - **虚词公式**可能会有遗漏,如有补充,欢迎通过此[链接](https://github.com/iapt-platform/mint/issues/20)给我们留言。

+ 16 - 0
documents/users_guide/zh-cn/studio_message.md

@@ -0,0 +1,16 @@
+## 消息功能
+通过消息功能,实现翻译的网络协作。
+
+只有具备**共享属性**的文档,才可以发消息。
+
+逐词译、译文的每次修改,都会发消息给协作者
+
+数据合并逻辑:
+- 用户数据大体包括四种状态
+  - 用户**手动**修改
+  - 他人**消息**推动
+  - 机器**自动**匹配
+  - 新经文中的**未填充**部分
+- 覆盖逻辑
+  - 手动>消息>自动>未填充
+-  未能覆盖则在改数据位置上显示<span style="color:#f9468f">消息数量</span>提示

+ 18 - 0
documents/users_guide/zh-cn/studio_parent.md

@@ -0,0 +1,18 @@
+## 词典原型
+此处为该处词语在查词时应该查询的拼写,通常是:
+- 动词去掉变位后,加上ti
+  - 如:karoma的原型写为karo(ti)
+- 名词、三性词去掉变格
+  - cittena的原型为citta
+
+正确输入词典原型,会在个人单词本中加入原型数据,利用该原型数据可以对其他变化词给出相对准确的含义。
+- 例如:cittena的**词典原型**中输入了citta,当以后遇到cittehi,cittāni会优先给出个人单词本中citta的数据。
+
+但如果是复合词拆分之后的组件,可以写衍生词的原型
+- karonta的原型为karo(ti)
+
+
+註:
+- 针对多层级变化衍生的关系,比如从词根到词干,动词到分词,分词到变格;我们不建议在此处进行多层级拆解
+- 我们设计了另一个强大的工具来实现**词源学探索的终极解决方案**——wordmap
+- 该wordmap工具在离线版的试验中可用,线上版有待恢复和重新设计

+ 6 - 0
documents/users_guide/zh-cn/studio_parent2.md

@@ -0,0 +1,6 @@
+## 衍生原型
+范例:
+- 拼写:karontassa
+- 词典原型:karonta(现代分词)
+- 此处:karo(ti)
+- 下拉菜单选择:prp(现代分词)

+ 24 - 0
documents/users_guide/zh-cn/studio_part_meaning.md

@@ -0,0 +1,24 @@
+## 拆分含义
+此处的设计是针对**信达雅**三大翻译指标中的**信**,即学术严谨性,可以通过拆分和拆分含义,实现词源学的探索。
+
+在**拆分方式**中用加号“+”将巴利拼写分隔之后,系统会根据每个组分的拼写进行自动查询
+
+查询结果的第一个会显示,其他结果在下拉菜单中
+
+点击<svg viewBox="0 0 24 24" id="ic_vertical_align_top" style='fill:#6baaff;height: 12px; width: 20px;'><path d="M8 11h3v10h2V11h3l-4-4-4 4zM4 3v2h16V3H4z"></path></svg>按钮可以将未 **[括起来]** 的部分覆盖到 **整体含义** 来实现快捷输入
+
+如果对译文不满意,可以点击<svg viewBox="0 0 24 24" id="ic_mode_edit" style='fill:#6baaff;height: 12px; width: 20px;'><path d="M3 17.25V21h3.75L17.81 9.94l-3.75-3.75L3 17.25zM20.71 7.04a.996.996 0 0 0 0-1.41l-2.34-2.34a.996.996 0 0 0-1.41 0l-1.83 1.83 3.75 3.75 1.83-1.83z"></path></svg>按钮来手动修改译文
+- 注意保证**拆分含义**的“+”和**拆分方式**中的“+”数量保持一致
+- 如果**拆分含义**的“+”数量小于**拆分方式**中的“+”,那么系统将自动填充 **↓↓** 来提示用户查看此处的下拉菜单
+- 如果**拆分含义**的“+”数量大于**拆分方式**中的“+”,那么系统将自动把最后两个组分含义合并
+  
+## 个人单词本
+拆分方式和拆分含义在进入[单词本](./setting.php?item=userdict)的时候,会在基础单词数据块的基础上,增加和拆分数目相同的单词数据块
+
+- 内容会被简化为拼写+含义,语法类型代码为**待定组分**
+- 比如:attha+saṃhita 义+已携带,会增加2条单词数据到[单词本](./setting.php?item=userdict)
+
+| 拼写    | 含义   | 类型     |
+| ------- | ------ | -------- |
+| attha   | 义     | 待定组分 |
+| saṃhita | 已携带 | 待定组分 |

+ 0 - 14
documents/users_guide/zh-cn/studio_parts.md

@@ -1,14 +0,0 @@
-## 拆分信息
-巴利语拆分是从词源入手进行语义解析的重要手段。
-
-用户可以根据自己的意愿决定把单词拆到什么程度。
-
-如果用加号“+”分隔每个组分,机器会自动识别并查询相应的组分。
-
-如果是连读词(sandhi)是可以进行进一步拆解和分别分析的。
-
-如果不清楚如何拆分,有几种渠道可供选择:
-- 点词查询;点击某个单词,点开右上角的<svg id="icon_dict" viewBox="0 0 32 32" style='fill:#6baaff;height: 10px; width: 15px;'><g transform="translate(-4 -4)"><path class="a" d="M24.4,2,17.9,7.85v14.3l6.5-5.85V2M8.15,5.9A12.09,12.09,0,0,0,1,7.85V26.908a.7.7,0,0,0,.65.65c.13,0,.195-.091.325-.091A15.85,15.85,0,0,1,8.15,26.05,12.09,12.09,0,0,1,15.3,28a15.659,15.659,0,0,1,7.15-1.95,13.241,13.241,0,0,1,6.175,1.378.565.565,0,0,0,.325.039.7.7,0,0,0,.65-.65V7.85A8.867,8.867,0,0,0,27,6.55V24.1a15.106,15.106,0,0,0-4.55-.65A15.659,15.659,0,0,0,15.3,25.4V7.85A12.09,12.09,0,0,0,8.15,5.9Z" transform="translate(5 4)"></path></g></svg>中会显示词典查询结果。
-- 巴缅词典(共三本),大部分都能找到拆分结果
-- **强力拆分**功能
-- 询问老师