维基教科书:维基项目 OpenRewi - 开放法律科学/写作

在本页面，您将找到在维基教科书中开始写作章节的技术指南。如果您有任何问题，请随时联系您的编辑。

一般说明

您不能在 Microsoft Word（或其他文字处理器）中编写您的文本，然后将其复制到维基教科书。相反，您必须使用下面描述的三种编辑选项之一。

您有三种不同的写作选项

1. 使用维基教科书的可视化编辑器在线写作
2. 使用维基教科书的源代码编辑器在线写作
3. 使用Atom 编辑器离线写作

无论您选择哪种技术，在维基教科书中工作都有四个基本规则

1. 在编辑您的章节之前，您需要注册并登录维基教科书。
2. 不要一次又一次地发布许多小的更改，而应该在您的编辑结束时同时发布所有更改（这样，其他人更容易跟踪更改）。
3. 在发布您的编辑之前，您应该仔细检查您的更改。您可以通过点击页面底部的“显示预览”来做到这一点。
4. 每个编辑都应该在“编辑摘要”下进行总结。

维基教科书写作文本编辑器

可视化编辑器

在维基教科书中编写、发布和修改文本的最简单方法是使用可视化编辑器。您可以通过点击章节顶部菜单栏中的“编辑”来选择可视化编辑器。

使用可视化编辑器写作非常类似于在 Microsoft Word 中写作。在顶部菜单栏中，您可以应用简单的格式化（例如，斜体、粗体或下划线），选择样式表（例如，标题、段落），插入列表或表格，并引用某些内容。这些元素大多是不言自明的。

通过点击顶部菜单栏中的“插入”，然后点击“模板”，您可以选择我们用于高级内容和示例的统一设计。

例如，要将一个用于高级内容的方框集成到您的文本中，您需要

1. 点击“插入”，
2. 点击“模板”，
3. 搜索模板（“OpenRewi/Advanced”），
4. 点击“添加模板”，
5. 在“引用”下输入您的标题，在“内容”下输入您的文本，并
6. 通过点击“插入”将方框添加到您的文本中。

如果您要插入一个示例，您需要在第三步中选择“OpenRewi/Example”模板，而不是“OpenRewi/Advanced”模板。

请确保不要更改我们的设计主题（例如，信息框），并遵循我们的样式指南（尤其是标题）。

源代码编辑器

您也可以使用源代码编辑器来编辑您的章节。您可以通过点击章节顶部菜单栏中的“编辑源代码”来选择源代码编辑器。

对于源代码编辑器，您必须使用所谓的维基语法。维基语法是 HTML 的简化标记语言。语法非常简单，因此您可以快速学习。有关在源代码编辑器中工作的详细说明，请点击此处查看。您可以在以下备忘单中找到 OpenRewi 最重要的维基语法命令列表。只需复制代码并将其粘贴到您的章节中即可。您只需要调整章节的内容。我们的样式指南详细描述了各个部分的使用目的。

备忘单：复制粘贴源代码

标题	代码	可视化
基本格式化	'''This is a bold text''', this is an ''italic text'', <u>this is an underlined text</u> and <s>this is a strikethrough text</s>.	This is a bold text, this is an italic text, this is an underlined text and this is a strikethrough text.
标题	==A. Heading == ===I. Sub-heading I=== ====1. Sub-heading II==== ===2. Sub-heading I=== ====a) Sub-sub-heading I==== =====aa) Sub-sub-sub-heading I===== ==B. Heading ==
列表	*This is a bulleted list #This is a numbered list	This is a bulleted list This is a numbered list
脚注	在科孚海峡案中，国际法院认定阿尔巴尼亚负有国家责任。<ref>[https://www.icj-cij.org/public/files/case-related/1/001-19490409-JUD-01-00-EN.pdf 科孚海峡案（英国诉阿尔巴尼亚）（案情）（1949）国际法院报告 4].</ref>	在科孚海峡案中，国际法院认定阿尔巴尼亚负有国家责任。
链接到其他章节	[[您的书籍/章节标题|链接到其他章节的显示文本]]	链接到其他章节的显示文本
使用锚点链接到其他章节	[[您的书籍/章节标题#锚点：您的锚点名称|链接到锚点的显示文本]]	链接到锚点的显示文本
链接文本中的锚点	{{anchor|您的锚点名称}}
链接到维基教科书外部的资源	[https://openrewi.org/en/english/ 链接到维基教科书外部资源的显示文本]	链接到维基教科书外部资源的显示文本
提供示例	{{Template:OpenRewi/Example|Content=This is your example.|Reference= example topic}}	示例主题示例： This is your example.
提供高级内容	{{Template:OpenRewi/Advanced|Content=This is your advanced content.|Reference=Heading for your advanced content}}	高级：Heading for your advanced content This is your advanced content.
嵌入交互式元素	{{Template:OpenRewi/Test|Link=Link to H5P element#your_anchor}}	测试您的知识 在我们的学习区.
源代码中的注释	<!--This is a comment.-->

Atom 编辑器

如果您更喜欢首先离线编写您的文本（而不是立即在可视化编辑器中编写，在那里每次中间保存也意味着发布），我们推荐您使用Atom程序。如果您想首先离线编写您的文本，您必须使用所谓的“维基语法”。这并不难，而且学起来很快（如上一节关于源代码编辑器的描述）。您可以在这个备忘单中找到 OpenRewi 最重要的命令概述。只需复制代码并将其粘贴到 Atom 编辑器中即可。您只需要调整章节的内容。有关在源代码编辑器中工作的详细说明，请点击此处查看。

要使用 Atom 离线编写文本，您需要按照以下步骤操作

1. 下载Atom并安装该程序
2. 根据以下步骤在 Atom 中安装 Mediawiki 包
   1. 打开 Atom 的首选项窗口
   2. 点击“安装”
   3. 搜索“language-mediawiki”并点击“安装”
3. 在右下角 UTF-8 和 Github 之间将格式设置为“Mediawiki”，而不是“纯文本”。
4. 开始在 Atom 中编写，不要忘记不时将您的文档保存到您的计算机上。
5. 一旦您使用维基语法在 Atom 中完成了章节的部分内容，您就可以将其复制粘贴到维基教科书的章节中，使用源代码编辑器进行操作。

嵌入交互式练习

欢迎您将交互式练习的链接嵌入到您的章节中。除其他事项外，您还可以创建单项选择题或多项选择题，以及填空文本。为此，您需要使用 H5P 框架。如何做到这一点将在下面描述。

要创建交互式练习，您需要按照以下步骤操作

1. 点击此[链接]，并使用编辑人员与您共享的数据登录。对于 PIL 团队，登录数据可以在[Nextcloud]中的此链接下找到。
2. 点击左侧边栏中的“H5P 内容”->“添加新内容”，并选择练习类型（例如，多项选择题、填空题等）。
3. 填写您所选练习类型所需的字段。
4. 向下滚动到“标签和标题”（德语：“Bezeichnungen und Beschriftungen”），并将语言从德语更改为英语。
5. 点击右上角的“创建”。
6. 复制右上角的短代码。

   [h5p id="your_number"]

7. 仔细检查您的练习。
8. 搜索您书籍中的“练习页面”，该页面由编辑创建。对于 PIL 团队，您可以在[此处]找到练习页面。
9. 在您的练习页面（历史、理论和方法；一般国际法；专门领域）上创建一段文字和一个标题（例如，“国家责任练习”）。
10. 将短代码复制到练习页面上的目标位置。
11. 设置锚点：点击您的短代码，在右侧边栏中选择“块”，然后在“高级”下的“HTML 锚点”中选择一个合适的描述，该描述末尾没有空格。
12. 将模板“OpenRewi/Test”添加到您的 Wikibooks 章，并输入您的书籍练习页面（第 8 点）的链接，并在链接后添加 "#" 和您的锚点名称。

    {{Template:OpenRewi/Test|Link=Link to H5P element#your_anchor}}

13. 发布您在 Wikibooks 上的更改，并检查您的练习链接是否有效。

    Note: Sometimes it can take a while until your exercise is displayed. It is best to simply restart the browser, clear the cache or make a test with another device.