首页
学习
活动
专区
工具
TVP
发布
精选内容/技术社群/优惠产品,尽在小程序
立即前往

Sphinx初尝

我们经常可以看到这种的doc文档,简洁大方.作为阅读可谓看着是赏心悦目 那么我能不能自己做一个这样的doc呢,我想是可以的,大家跟着我试试看!...请输入以下设置的值(只需按Enter 接受默认值(如果在括号中给出)。 选定的根路径:。 您有两个选择来放置Sphinx输出的构建目录。...您可以在根路径中使用目录“ _build”,也可以单独使用 根路径中的“源”和“构建”目录。 有一些提示,自己摁 项目名称将在生成的文档中的多个位置出现。...//www.sphinx-doc.org/en/master/usage/configuration.html ---- project 记录的项目名称。...)] 重新编译没有变化 为了可以自动预览,用cmd 还是主题未变,之后在解决 支持markdown文件、更改文档主题 Spinx本身不支持.md文件生成文档,需要我们使用第三方库recommonmark

1.6K20
  • 您找到你想要的搜索结果了吗?
    是的
    没有找到

    Mirages主题帮助文档

    更新主题和插件 主题在后台的控制台->外观->设置外观页面提供了主题最新版本的检测功能。在有新版本之后,您可以选择使用在线更新或手动更新来完成主题和插件的更新操作。 1....目前我这边没有什么比较靠谱的二维码 API,你可以进入主题外观设置更换自己的二维码 API,或者使用热心网友提供的二维码 API。...文章分类的主图 / 头图 / Banner 怎么设置? 分类的主图不可以手动设置。分类的主图的获取逻辑为: 随机取当前分类下非第一篇文章设置的文章主图,如果文章中没有设置主图则取不到主图。...主题首页大图 / 文章主图 / banner 无法加载,显示为黑色 建议检查一下图片链接是否正确,图片链接通常需要以 http:// 或 https:// 开头,且链接没有防盗链限制(从我博客复制的图片链接是会有防盗链的哦...标题默认显示在文章主图中,没有文章主图会显示默认背景色。

    10.1K20

    WordPress主题Siren二开美化版

    首先感谢他们的作品呢…… 因为博主超喜欢单栏主题的设计,还有 PJAX 加载,所以博主一直就在打磨这款主题中…… (当然是根据自己喜欢的口味来更改滴啦) 学长是个细节控,代码洁癖,某些强迫症集一身的人啦...…… (才不是处女座呢,学长是风象天秤座的) 所以在打磨这款主题在细节处纠结了 N 多遍后才能有决定的说…… 嗯,好作品感觉就是要分享出去才行呢…… (自己封的好作品称号,2333) 对比 Siren...文章列表、文章或者页面的顶部图片显示顺序: 优先显示编辑文章时所设定的特色图,没有设置特色图的情况下的逻辑和上一条一样。...修复评论中贴出代码时,翻页评论时 Prism 代码高亮失效的问题 2018.06.08 更改友链页面代码,按照链接分类显示,支持自定义分类名称了 友链页面新增一个“瀑布流”样式,在主题“其它”设置中可以找到并更改...全局字体使用“微软正黑体”,更具逼格 整理了一个博主万年没有发现的东西 —— 主题居然自带(BAGUETTEBOX.JS)图片灯箱,只是使用条件苛刻,添加图片时需要把文件“链接到媒体文件”才能使用,也就是

    4K30

    sphinx入门指南【1】快速入门

    安装 使用pip进行安装: pip install sphinx 设置源文件目录 包含.rst文件的根目录称之为源文件目录,目录中还包含sphinx的配置文件conf.py。...toctree指令的初始值为空: .. toctree:: :maxdepth: 2 接下来就可以给它添加子文档的链接了,直接使用文档的名称即可,省略掉文件后缀,如果是多级目录,则使用/分隔开。...对象文档 sphinx的设计初衷之一就是更容易生成任何域中对象的文档,域指很多对象的集合,这些对象中还包含了相应的文档注释。...因此需要在sys.path中设置好模块的路径。 设置主题 推荐使用readthedoc使用的主题,美观又简洁大方。...首先安装主题库: pip install sphinx_rtd_theme 然后配置conf.py: import sphinx_rtd_theme html_theme = "sphinx_rtd_theme

    2.2K40

    Sphinx+gitee+Read the Docs搭建在线文档系统

    sphinx-quickstart 然后会有如下的输出,需要根据提示输入项目名称、作者、版本号、语言等信息 G:\TestProject\sphinx\SphinxDemo>sphinx-quickstart...2.6 更改样式主题 上面的测试效果,使用的是默认的主题alabaster,如果想安装其它的主题,可以先到Sphinx的官网https://sphinx-themes.org/查看: ?...这里选用一个较为常用的主题Read the Docs,安装这个主题首先需要在python中进行安装,命令如下: pip install -i https://pypi.tuna.tsinghua.edu.cn...将gitee仓库的HTTPS链接复制过来 ? 填写项目名称,填写gitee仓库的HTTPS链接 ? 然后就可以点击Build version进行项目构建了 ?...6 搭建过程演示视频 本文的模板工程已整理至我的gitee ? 点击https://gitee.com/xxpcb/sphinx-demo,可以直达此项目的gitee仓库~

    2K30

    PowerBI 使用微软雅黑字体 让中英文完美显示 60%面试者倒在该题下

    问题在于: 在英文语言状态下,中文使用了默认使用了宋体,确实比较不太好看。 请仔细注意上述两个切片器,头名称【细分】和【Channel】下面的下拉框的上边缘是不对齐的。...很显然该字体可以很好的兼容中文和英文的显示,所以,您只需要设置 PowerBI 的默认字体为微软雅黑即可。 可以问题来了: ? 我晕,居然没有设置微软雅黑的选项。...因此,该考题:如何统一中英文字符在 PowerBI 中的良好显示就真的变成了一个有意义的考题。有没有意识到以及会不会该考题的答案,直接分界一个设计师是否细化到了 PowerBI 的主题设置。...在 PowerBI 2019年12月更新后,我们可以轻松的利用 PowerBI 主题编辑器了,如下: ? 我们可以点击【视图】【主题】【自定义当前主题】,如下: ?...当然了,在这里,你也没有机会选择【微软雅黑】,但我们可以做一个操作,将所有涉及主题字体的,全部设置成一个临时值,例如:Arial,目的是为了导出。 ?

    5.7K41

    Z-blogPHP常见问题答疑(最新整理202105)

    最新解决办法: 因为后期更新了图文推荐的形式,所以以上问题在后台设置,外观设置,侧栏图文数量填写数字,例如图片: ? 设置完毕,更新下缓存即可。...二次修改使用 主题都是按照大众的审美或者按照开发者的角度去制作,有些体验不是那么的好,想删除某一块或者修改某一块,具体的修改因人而异这里就不说了,问题是修改主题之后,打开网站并没有变化,于是再次修改,还是没有效果...问题又来了,有些主题修改好了,下次更新又恢复原来的样式了,这个暂时没有办法解决,但是设计到主题样式的可以解决,即使更新模板也不会更改,解决办法,有些主题在开发的时候就设置了自定义css样式的接口,就是说我们只需要把想替换的...css写入主题的接口就可以了,这样即使更新了主题,还是会优先使用自定义的样式,比如我的主题就有这样的接口,后台,主题设置,找到外观设置,添加你喜欢的css样式即可,如图,记得打开开关哦。...附奥森图标网址:图标传送门 关于项目介绍模块设置教程: 首先找到左侧菜单,模块管理,点击新建模块 ? 设置名称(可自定义)文件名和ID“divproject”不可更改,设置如图: ?

    48720

    李洋个人博客《mxlee》zblog主题-梦想家(精品推荐)

    这款主题制作了好久,历时一个多月,曾经几度要放弃这个主题了,最终还是不舍,至于原因嘛,,,因为我感觉越来越像《知更鸟》主题,最开始我打算做一款自用主题,把自己喜欢的元素都添加在内,但是做完才发觉主题真的很不错...关于右侧项目介绍模块设置教程: 首先找到左侧菜单,模块管理,点击新建模块 设置名称(可自定义)文件名和ID“divproject”不可更改,设置如图: 类型选择“UL”,正文内容如下(部分名称和链接自己修改...--.修改cms首页横向轮播选择分类出错的BUG; --.新增右侧客服的QQ功能;(有开关) --.修正自定义缩略图出错问题; --.修改幻灯片php代码循环问题; --.自定义首页博主介绍最后一个栏目的自定义...: 注意:更新之后这可能会导致不显示图标,因为后台没有这个内容的数据,如图修改,主题设置,基本设置,滚动条拉至最下,可以看到订阅设置,这个自定义填写FONT图标和连接,比如之前默认的是:订阅按钮,那么直接填写对应的图标连接即可...可自定义css: 在使用主题的过程中,我们可能会不喜欢某一些,需要简单修改一下,但是修改css的话下次更新还是会被覆盖,这就尴尬了,所以这个主题在后台添加了一个自定义css的接口,有修改的话,直接开启,

    2.1K20

    主题的隐藏功能

    基本配置 网站主题色配置 如果时间久了对一种颜色不喜欢了,怎么办?那么就来换一个颜色,黄色、绿色、红色还有各种中国色...随你挑! 请在这里设置网站主题色 ?...主题提供自动暗夜暗夜模式的时间区间配置,可以看后面两项 滚动条 配置位置:基本配置 -> 自定义滚动条 不喜欢默认滚动条怎么办,用寒山主题后台配置就好了。支持自定义颜色。 ?...博主这里说一下吧,其实我在文章页面花费了很多心思,因为我觉得作为一个技术项的博客网站,除了内容之外,还有就是文章的阅读体验,所以我自己觉得此文章页面很适合阅读。...首页图片支持非全屏 在主题设置中关闭 ?...我们可以在管理后台主题中设置: ? 这里只需要加上网易云歌单id就可以了。 PJAX 本主题在 1.4.0 之后将会支持 PJAX 刷新,我们可以在主题设置中开启。 ?

    80330

    使用 Sphinx 给 Python 项目生成【Read the Docs】在线文档

    Sphinx 和 Read the Docs 1.1 Sphinx Sphinx 是一个强大的文档生成器,具有许多用于编写技术文档的强大功能,包括: 维护一份源文档,生成网页,可打印的PDF,用于电子阅读器...1.3 两者关系 可以简单认为 Sphinx 是一个独立的文档生成工具,可以支持不同的主题;而 Read the Docs 是一个免费的在线文档托管平台,它使用 Sphinx 作为文档生成工具,并提供自己的主题...安装 2.1 安装 Sphinx pip install sphinx 2.2 安装 Read the Docs 主题 pip install sphinx_rtd_theme * 2.3 安装 Sphinx...默认主题是 alabaster (sphinx 其他内置主题参考文末链接 [6]),将其改为 sphinx_rtd_theme。...5.2 更改项目配置 进入项目页面-管理-高级设置。 选择【默认分支】为 docs 将【Python 配置文件】改成 docs/source/conf.py 点击底部 【Save】按钮,保存更改。”

    3.5K20

    【说站】Z-blogPHP常见问题答疑

    最新解决办法: 因为后期更新了图文推荐的形式,所以以上问题在后台设置,外观设置,侧栏图文数量填写数字,例如图片: 设置完毕,更新下缓存即可。...二次修改使用 主题都是按照大众的审美或者按照开发者的角度去制作,有些体验不是那么的好,想删除某一块或者修改某一块,具体的修改因人而异这里就不说了,问题是修改主题之后,打开网站并没有变化,于是再次修改,还是没有效果...问题又来了,有些主题修改好了,下次更新又恢复原来的样式了,这个暂时没有办法解决,但是设计到主题样式的可以解决,即使更新模板也不会更改,解决办法,有些主题在开发的时候就设置了自定义css样式的接口,就是说我们只需要把想替换的...css写入主题的接口就可以了,这样即使更新了主题,还是会优先使用自定义的样式,比如我的主题就有这样的接口,后台,主题设置,找到外观设置,添加你喜欢的css样式即可,如图,记得打开开关哦。...关于项目介绍模块设置教程: 首先找到左侧菜单,模块管理,点击新建模块 设置名称(可自定义)文件名和ID“divproject”不可更改,设置如图: 类型选择“UL”,正文内容如下(部分名称和链接自己修改

    1K10

    Halo博客主题开发之全局变量模板标签调用整理(Halo主题开发必备)

    此变量与后台博客设置中的 博客地址 相对应。 2、网站根路径 ${context!} 需要注意的是,此变量和 blog_url 不同的是,这个变量有两种值,一种为相对路径形式,一种为绝对路径形式。...假设你的主题在 ~/halo-dev/templates/themes/anatole 这个目录,那么 theme_base 为 https://yourdomain/themes/anatole 举个例子.../css/style.css 4、主题信息 主题名称 ${theme.name!} 主题 git 仓库地址 ${theme.repo!} 主题版本号 ${theme.version!}...需要注意的是,虽然这个变量在任何页面都可以使用,但是其值可能在不同的页面是不一样的。会根据用户的设置,生成对应的值。 10、SEO描述 ${meta_description!}...需要注意的是,虽然这个变量在任何页面都可以使用,但是其值可能在不同的页面是不一样的。会根据用户的设置,生成对应的值。 11、RSS 2.0 订阅地址 ${rss_url!}

    92610

    博客生成静态站点工具 Top 20

    VuePress 的目标是用于快速搭建文档型网站,并且可以支持自定义主题、插件等功能。 VuePress 使用 Markdown 来写作和生成网站内容,同时支持 Vue 组件和自定义页面。...可以使用多种主题和插件来自定义文档页面,使其更具有个性化和专业性。 支持多种扩展功能,如搜索、站点导航、代码高亮等。 可以与Git等版本控制系统集成,方便协作和管理文档。...多主题支持:Publii提供了多种现成的主题,用户可以选择适合自己的主题,也可以自定义样式。 支持多语言:Publii支持多种语言,用户可以选择自己的语言来创建和管理博客。...Sphinx具有以下特点: 灵活性:Sphinx支持多种标记语言(如reStructuredText、Markdown等),并提供了多种主题和插件来自定义文档样式和功能。...多种输出格式:Sphinx支持生成HTML、PDF、EPUB等多种格式的文档,方便发布和分享文档。 社区支持:Sphinx 是一个开源项目,有庞大的社区支持和开发者社区,您可以轻松地获取帮助和支持。

    3.9K21

    Zeus Sphinx恶意软件重现,利用COVID-19救济款进行网络钓鱼

    近期发现Zeus Sphinx银行木马程序在沉寂了三年后重新回归人们视线——以冠状病毒为主题开展网络钓鱼活动。COVID-19是目前网络攻击最为常见、最为流行的主题。 ?...Zeus Sphinx恶意软件背后的运营商进行了测试所致。”...“看来,利用当前的特殊形势,Sphinx的运营商将目光投向了等待政府救济金的人。” ? (钓鱼邮件样本) 与以前的活动一样,Zeus Sphinx的运营商仍盯着美国、加拿大和澳大利亚的大型银行。...,这减少恶意程序的存在时间且不会进行版本升级” Sphinx使用Tables 的Web控制面板进行网络注入,它会下载和感染用户匹配的银行网站自定义文件,这会让人更加信服,增加注入的成功率。...众多恶意软件中的一种 在COVID-19疫情期间,有许多以此为主题进行攻击的恶意软件,Sphinx也只是其中的一种。

    58120

    一款拥有漂亮外表的Typecho简洁主题-Scarfskin

    介绍 Scarfskin汉译为外皮,如你所见,这是一款拥有漂亮外表的主题,没有繁杂的侧栏,更没有不知所措的功能(已停止更新增加功能),就是直接而又漂亮的外表和纯粹的文章展示。...她真的很适合一个对于多样性功能要求并不高而却想要很好看的个人博主,在图片的强烈装饰下,让仅仅有几篇内容的站点也显得如此漂亮。...CSS样式、底部内容、文章末版权信息 评论支持Emoji表情,需后台选择开启和禁用 网页延时加载loading动态图,后台自定义 文章点赞打赏功能,Pjax预加载功能 主台主题模板设置数据的备份与恢复...主题设置,必须设置 文章列表顶图地址 和 随机缩略图地址 不然显示效果很差! 归档页面: 管理->独立页面->新增独立页面,标题自定义,自定义模板选择 归档 然后直接发布。...友情链接的添加方式: 在友链页面添加自定义字段,字段名称设置为 links,字段值请按照下方的格式输入。

    2.4K31

    【数据可视化】Echarts的高级功能

    2.2 自定义ECharts主题 ECharts除了默认主题样式之外,还可以使用主题在线构建工具,根据需求快速直观地生成主题配置文件,并在ECharts中使用自定义的主题样式。...自定义主题的步骤如下。 (1)打开ECharts的主题构建工具 (2)选择和配置主题。在ECharts的主题构建工具中,有十几套主题可以选择。如果这些主题还满足不了需求,那么还可以设置各种配置。...导出的“.json”格式的文件仅用于在ECharts的主题构建工具中导入使用,而不能直接作为主题在ECharts页面中使用。 3....回调函数本身是主函数的一个参数,将回调函数作为参数传到另一个主函数中,当主函数执行完后,再执行回调函数。这个过程就叫作回调。...-all.js才可设置effect属性)、自定义的数据加载动画蒙板颜色等属性。

    50610

    WordPress面试题

    ,该文件夹即为你的主题名称。...创建主题文件: 在主题目录下创建一个style.css文件,定义主题的基本信息,包括主题名称、作者、描述等。 创建一个index.php文件,作为主题的入口文件。...使用WP_Query等函数创建自定义循环,显示特定条件下的文章。 响应式设计: 使用媒体查询或使用框架(如 Bootstrap)来确保主题在不同设备上都有良好的显示效果。...创建插件文件: 在插件目录下创建一个主插件文件,通常命名为plugin-name.php。 添加插件信息: 在插件文件中添加插件的基本信息,包括插件名称、版本、描述等。...自定义功能: 在插件文件中定义自定义功能,可以是短代码、小部件、自定义查询等。 使用 WordPress 提供的函数,如get_option、update_option等,来处理插件的设置。

    40040

    将美化进行到底,使用 Oh My Posh 把 PowerShell 做成 oh-my-zsh 的样子

    因为我们还没有装好字体,现在格式混乱,所以也很难挑选真正喜爱的主题。 至此,Oh My Posh 模组已经可以在每次启动 PowerShell 时自动加载了。...第三步:安装字体、挑选主题 关于字体,小提一下:如果你直接使用 PowerShell 而不使用终端的话,字体的定制会非常麻烦,可参见 自定义 Windows PowerShell 和 cmd 的字体 感受一下...挑好后,去修改 Microsoft.PowerShell_profile.ps1 文件内容,换主题名。 图片 这里,我选了 iterm2,于是就有了本文一开始的美化效果了。...同样,在 Visual Studio Code 里设置一下终端字体也可以在 Visual Studio Code 里看到相同的效果: 主题在这个文件夹下,可以自行编辑: ~\Documents\PowerShell...基于自带的 iterm2 魔改了一个 iterm3 主题,他授权我在这里分流提供给大家下载。我觉得非常好看,就白瞟了。

    2.7K40
    领券