小说网站源码是一套文本自动聚合搜索和展示构建系统,设计用于编写由许多较小的文本文档组合而成的小说网站。它使用了受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-novelalify`,
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/narative`,
},
{
name: `github`,
url: `https://github/narative`,
},
],
},
plugins: ['@narative/gatsby-theme-novela'],
};
完成所有步骤后,就可以运行站点了。
更多推荐
小说站源码(带自动采集开源小说网站源码)
发布评论