标签：步骤 narative 开源 源码 novela gatsby 小说 添加
小说网站源码是一套文本自动聚合搜索和展示构建系统，设计用于编写由许多较小的文本文档组合而成的小说网站。它使用了受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'],
};
完成所有步骤后，就可以运行站点了。
标签：步骤,narative,开源,源码,novela,gatsby,小说,添加 来源： https://blog.csdn.net/AMikMy/article/details/117416267
本站声明： 1. iCode9 技术分享网（下文简称本站）提供的所有内容，仅供技术学习、探讨和分享； 2. 关于本站的所有留言、评论、转载及引用，纯属内容发起人的个人观点，与本站观点和立场无关； 3. 关于本站的所有言论和文字，纯属内容发起人的个人观点，与本站观点和立场无关； 4. 本站文章均是网友提供，不完全保证技术分享内容的完整性、准确性、时效性、风险性和版权归属；如您发现该文章侵犯了您的权益，可联系我们第一时间进行删除； 5. 本站为非盈利性的个人网站，所有内容不会用来进行牟利，也不会利用任何形式的广告来间接获益，纯粹是为了广大技术爱好者提供技术内容和技术思想的分享性交流网站。