当前位置: 首页 > news >正文

wordpress网站之间互联/网络app推广是什么工作

wordpress网站之间互联,网络app推广是什么工作,响水做网站的价格,空间网站建设大家一定见过这样的文档吧?这种黑白色调看起来非常舒服,整个界面干净简洁却显得很有档次。 而这文档主要是由Read the Docs这个在线文档托管、Sphinx这个基于Python的文档生成项目以及我们常用的版本控制工具GitHub实现的,下面我们就来梳理一…

大家一定见过这样的文档吧?这种黑白色调看起来非常舒服,整个界面干净简洁却显得很有档次。

file

而这文档主要是由Read the Docs这个在线文档托管、Sphinx这个基于Python的文档生成项目以及我们常用的版本控制工具GitHub实现的,下面我们就来梳理一下如何生成文档。

创建仓库

首先,我们需要在GitHub上创建仓库并将该仓库克隆到本地,当然你也可以直接在原有仓库上进行操作。

file

注册账号并连接到GitHub

接着我们需要在ReadtheDocs官网注册一个账号,https://readthedocs.org/ ,注册成功后在设置中选择已连接的服务,并点击Connect to GitHub按钮。

file

项目导入

在个人面板点击Import a Project,选择需要创建文档的项目,若是未找到目标项目,可以点击右上角的刷新并等待。

file

构建文档

导入项目之后,我们点击Build version即可成功创建文档

file

等待片刻后即可构建完成,Webhook自动添加之后只要更新GitHub仓库,项目文档就会自动重新构建。

file

然后我们就能够看到文档的雏形

file

添加文档

在做完上述前期工作之后,我们要来动手书写自己的文档。首先,我们需要安装Sphinx(速度较慢,建议切换成清华镜像下载),

pip install sphinx sphinx-autobuild sphinx_rtd_theme
pip install sphinx sphinx-autobuild sphinx_rtd_theme -i https://pypi.tuna.tsinghua.edu.cn/simple

接着我们进入到本地仓库目录,进行初始化,

sphinx-quickstart

可以通过一直回车来使用默认配置,在这里我主要选择了source和build目录分离,并且使用中文为项目语言。

Separate source and build directories (y/n) [n]:y
Project language [en]: zh_CN

然后我们可以通过修改source/conf.py文件来更改文档主题并添加markdown文件的支持(需要安装recommonmark)。

import sphinx_rtd_theme
html_theme = "sphinx_rtd_theme"
html_theme_path = [sphinx_rtd_theme.get_html_theme_path()]from recommonmark.parser import CommonMarkParser
source_parsers = {'.md': CommonMarkParser,
}
source_suffix = ['.rst', '.md']

我们可以通过在项目根目录执行下述命令在本地生成html文件

make html

并且在build/html/index.html中来预览项目文档

file

最后,我们只需要修改index.rst文件便可以修改文档内容,reStructuredText 是扩展名为.rst的纯文本文件,含义为"重新构建的文本",其是轻量级标记语言的一种,被设计为容易阅读和编写的纯文本,并且可以借助Docutils这样的程序进行文档处理,也可以转换为HTML或PDF等多种格式,或由Sphinx-Doc这样的程序转换为LaTex、man等更多格式,如何书写可以参考下面给出的链接。

参考资料

  • Quick reStructuredText
  • Sphinx官方文档
http://www.lbrq.cn/news/1100179.html

相关文章:

  • 网站制作与建设书籍/搜索引擎排名google
  • 专做充电器的网站/搜索引擎大全排名
  • it做私活的网站/人民网今日头条
  • 温州做网站建设多少钱/怎么样做推广最有效
  • 自贡网站建设公司/中国关键词
  • 通州网站制作/seo是什么职位简称
  • 推荐武汉手机网站建设/百度获客
  • 西安做网站哪里价格低/品牌宣传有哪些途径
  • 浙江建设信息网港/东莞关键词seo
  • 广州建设网站是什么/搜狗收录入口
  • 百度seo优化技巧/西安优化外
  • 装饰公司315活动网站怎么做/百度极速版下载安装
  • 哪些网站建设公司好/病毒式营销方法
  • 注册了域名怎样做网站/上海网站排名推广
  • 查一下红之易道学做的什么网站/whois域名查询
  • 东营建站/亚洲7号卫星电视
  • 网站开发需要考虑哪些方面/互联网推广平台
  • 做网站用是内网穿透好/一个完整的产品运营方案
  • 服务器做网站配置/热搜榜百度一下你就知道
  • 自己做的网站怎么在百度可以查到/百度统计收费吗
  • 哪个网站做学历认证/seo推广排名
  • 微信产品展示小程序/百度sem优化师
  • 广州专业做网站建设/百度竞价排名一年费用
  • 代理建设网站/淘宝联盟怎么推广
  • 单页网站制作教程/北京搜索引擎优化经理
  • 帮建网站的人/信息推广
  • wordpress 博客地址更改/优化流程
  • 免费的网站程序哪里好/竞价广告是怎么推广的
  • e网站建设/微营销平台
  • 展示型网站 asp.net/识图
  • HTTP,HTTPS
  • [Python] -项目实战10- 用 Python 自动化批量重命名文件
  • 基于python django的BOSS直聘网站计算机岗位数据分析与可视化系统,包括薪酬预测及岗位推荐,推荐算法为融合算法
  • LP-MSPM0G3507学习--07定时器之二定时节拍
  • FMEA-CP-PFD三位一体数字化闭环:汽车部件质量管控的速效引擎
  • 【音视频协议篇】RTSP系列