小说网站源码是一套文本自动聚合搜索和展示构建系统，设计用于编写由许多较小的文本文档组合而成的小说网站。它使用了受Markdown启发的最小格式语法，并添加了用于注释、概要和交叉引用的元数据语法。它被设计成一个简单的文本编辑器，允许轻松组织文本和注释，使用人类可读的文本文件作为存储，以实现健壮性。
　　小说站源码演示：xsymz.icu
　　项目存储适用于版本控制软件，也适用于文件同步工具。所有文本都保存为带有元数据头的纯文本文件。核心项目结构存储在一个项目XML文件中，其他元数据主要保存为JSON文件。

　　小说站源码的构建核心：
　　该源码是用Python 3(3.6+)编写的，使用Qt5和PyQt5(5.3+)。它是在Linux上开发的，但原则上应该可以在其他操作系统上很好地工作，只要满足依赖关系。它定期在Debian和Ubuntu Linux、Windows和macOS上进行测试。
　　小说站源码的特性：
　　源码不是一个合适的Markdown编辑。它是一个纯文本编辑器，使用类似于markdown的语法来允许对编写小说的特定任务有用的最小格式集。格式目前仅限于:
　　标题级别1到4使用＃语法。
　　强调和强烈强调的文本。这些被渲染为斜体和粗体文本。
　　加删除线的文本。
　　硬换行在一行的末尾使用两个或多个空格。
　　就是这样。在使用导出工具时，编辑器中不支持的特性也不会导出。
　　此外，novelWriter还为其附加特性添加了以下语法:
　　一行以％视为注释，除非请求，否则不会在导出上呈现。评论不计入字数和其他统计数据。
　　如果注释的第一个字是剧情简介:，注释将被索引，并被视为出现注释的文本部分的概要。这些大纲注释可用于构建大纲并导出到外部文档。
　　以字符开头的一组元数据关键字/值＠． 它们用于标记和相互链接文档，也可以在生成项目大纲时包括在内。
　　支持各种薄的和不间断的空间。其中一些依赖于至少运行Qt 5.9的系统。很不幸，早期版本的Qt会在保存时去掉它们。
　　选项卡可以在文本中使用，并且应该在编辑器和查看器中正确对齐。这可以用来制作简单的表格和列表。注意，对于HTML导出，大多数浏览器将选项卡视为空格，因此它可能不会像预期的那样显示。打开文档输出应该产生预期的结果。
　　novelWriter的核心输出格式是Open Document和HTML5。Open Document是大多数办公应用程序支持的办公类型文档的开放标准。更多详细信息请参见Open Document > Application Support。
　　您还可以将整个项目导出为一个novelwriter风格的文档。这些稍后可以再次导入到novelWriter中。此外，Qt库还提供了打印和导出到PDF的功能，尽管有格式化方面的限制。
　　小说网站源码安装：对于常规安装，建议您从Releases页面或小说作者页面下载最小的zip文件。io的网站。该文档提供了Linux、Windows和macOS的详细安装说明。它们非常简单。
　　如果希望直接从源代码运行novelWriter，则必须从命令行运行novelWriter.py文件。
　　注意:在某些系统上，您可能需要在下面的说明中将python替换为python3，将pip替换为pip3。您可能还希望添加——user标志，以便pip只安装在您的用户空间中。
　　依赖通常可以通过以下方式从PyPi安装:PIP install -r requirements.txt
　　Linux的其他步骤
　　在Linux上，您很可能在发行版的存储库中找到依赖项。在Ubuntu和Debian上运行:
　　安装python3-pyqt5 python3-lxml python3-enchant
　　如果你想在Linux上设置启动器和图标，你可以运行:
　　python setup . py xdg-install
　　macOS的其他步骤
　　首先，确保你已经用Homebrew正确设置了Python3。如果没有，检查他们的文档。另外，安装所有依赖项需要执行以下步骤:
　　Brew install enchant pip3 install——user -r requirement .txt
　　Windows的其他步骤
　　Windows默认情况下没有安装Python，请记住在安装过程中选择“Add Python to PATH”。
　　安装文件夹中的脚本windows_install.bat可用于为novelWriter创建桌面和开始菜单图标。该脚本还将从PyPi为您安装依赖项。
　　小说站源码关键机制：
　　步骤1:安装
　　# Create an empty directory and go into it
　　mkdir novela-site && cd novela-site
　　# Add all required dependencies
　　yarn add react react-dom gatsby @narative/gatsby-theme-novela
　　步骤2:文件夹结构
　　一旦你安装了React, Gatsby和Novela，你就会想要添加你的第一个Author和Post。
　　你的内容和网站的推荐项目结构是这样的:
　　novela-site
　　├── content
　　│ ├── authors
　　│ │   ├── avatars
　　│ │   │    └── avatar.jpg
　　│ │   └── authors.yml
　　│ └── posts
　　│     └── 2020-01-01-my-first-novela-post
　　│         ├── images
　　│         │   └── novela-hero.jpg
　　│         └── index.mdx
　　├── node_modules
　　├── gatsby-config.js
　　└── package.json
　　步骤3:使用@narative / gatsby-theme-novela
　　必须在gatsby-config.js中添加@narative/gatsby-theme-novela插件。@narative/gatsby-theme-novela可以通过插件选项进行配置，但我们现在将使用默认值。
　　// gatsby-config.js
　　module.exports = {
　　plugins: ['@narative/gatsby-theme-novela'],
　　};
　　一旦你在gatsby-config.js中设置了@narative/gatsby-theme-novela插件，你就可以开始创建你的第一个帖子了。为了创建一个帖子，你还需要至少一个作者。
　　步骤4:添加Author
　　在步骤2中，我们创建了项目的文件夹结构。我们现在可以通过填充/content/authors/authors.yml来添加一个Author:
　　novela-site
　　└── content
　　└── authors
　　├── avatars
　　│    └── brotzky-avatar.jpg
　　└── authors.yml
　　在作者。yml添加一个Author。必须至少有一个有特色的作者。
　　/ /作者/ authors.yml内容:
　　步骤5:添加帖子
　　一旦在authors中至少定义了一个Author。yml你可以添加你的第一个帖子。
　　首先在content/posts中创建一个新文件夹。你可以给它起任何你喜欢的名字，但是我们建议在前面加上日期来组织你的帖子。一旦您创建了您的文件夹，您可以添加索引。MDX文件和一个图像文件夹。
　　---
　　title: Why Narative loves Gatsby
　　author: Dennis Brotzky
　　date: 2019-04-27
　　hero: ./images/narative-gatsby-hero.jpg
　　excerpt: This is a love story about Narative and Gatsby
　　---
　　# And then under the heading YML you can insert any MDX you like
　　# like headings, links, code, images, etc
　　# This will show up in the body of your post
　　# ...
　　步骤6:配置siteMetadata
　　为了配置主题以正确地生成页面和元标记，您必须向sitemetdata添加特定的数据。
　　Novela独有的领域是英雄。标题,英雄。maxWidth和社会。
　　将站点元数据添加到gatsby-config.js文件中。
　　// gatsby-config.js
　　module.exports = {
　　siteMetadata: {
　　title: `Novela by Narative`,
　　name: `Narative`,
　　siteUrl: `https://gatsby-theme-novela.netlify.com`,
　　description: `This is my description that will be used in the meta tags and important for search results`,
　　// important to set the main text that appears in the hero
　　hero: {
　　heading: `Perspectives on technology, design and business from the team at Narative.`,
　　maxWidth: 652,
　　},
　　social: [
　　{
　　name: `twitter`,
　　url: `https://twitter.com/narative`,
　　},
　　{
　　name: `github`,
　　url: `https://github.com/narative`,
　　},
　　],
　　},
　　plugins: ['@narative/gatsby-theme-novela'],
　　};
　　完成所有步骤后，就可以运行站点了。