Sphinx Building Docs in horizon】的更多相关文章

Building Contributor Documentation This documentation is written by contributors, for contributors. The source is maintained in the doc/source directory using reStructuredText and built by Sphinx Building Automatically: $ ./run_tests.sh --docs Buildi…
昨天是4月14日,也是我的23岁生日.正好去参加GDG举办的WTM,这次的主题是building a new horizon. 写一下印象深刻的分享者和她们的闪光点. 1.羡辙-从灵感到落地 羡辙是在开源社区比较活跃的人,主要在做的是前端可视化的项目.她分享的是如何激发.记录并落地自己的灵感,并将这些落地的项目开源分享出来.主要介绍了自己四个有意思的小项目,分别是与羡辙聊天中.动态水球效果.在线婚礼的小动画以及口红色号的可视化.羡辙是一个比较有脑洞和执行力的人,她希望能有更多人也能和她一样,去落…
在使用Python.Django的过程中,经常看到docs目录,里面存放着一些txt文本文件,也就是自带的一些帮助文档,里面有make.bat,在dos目录下直接执行make,给出的帮助是可以转换成Html.PDF等文件形式,那么,怎么转换这些帮助文档呢?直接执行make html发现提示sphinx-build不是内部或外部命令,在网上下载了Sphinx,并安装,再次执行make html时发现还是提示不是内部或外部命令,最后发现,Sphinx安装后,并没有在Python安装目录中生成Sphi…
文档生成工具: 自带的pydoc,比较差 建议使用sphinx 安装: pip install sphinx 安装主题: 由各种主题,我选择常用的sphinx_rtd_theme pip install sphinx_rtd_theme 使用方法: 1.创建文件夹doc:mkdir doc:cd doc:执行sphinx-quickstart,进入引导,根据需要选择yes或者no 2.执行sphinx-quickstart引导程序只会生成一个index.rst 3.在doc目录下执行sphinx…
openstack按照官网docs部署horizon后,使用admin账号密码登录,但网页提示未知错误. 查看/var/log/httpd/error_log 提示这个:RuntimeError: Unable to create a new session key. It is likely that the cache is unavailable. 缓存有问题,在外国网站找到解决方案: 将 /etc/openstack-dashboard/local_settings 里的 SESSION…
版本控制 说到版本控制,脑海里总会浮现大学毕业是写毕业论文的场景,你电脑上的毕业论文一定出现过这番景象! 毕业论文_初稿.doc 毕业论文_修改1.doc 毕业论文_修改2.doc 毕业论文_修改3.doc 毕业论文_完整版1.doc 毕业论文_完整版2.doc 毕业论文_完整版3.doc 毕业论文_最终版1.doc 毕业论文_最终版2.doc 毕业论文_死也不改版.doc ... 以上就是使用最原始的方式进行版本控制,但是这种方式有显著缺点: 多个文件,保留所有版本时,需要为每个版本保存一个文…
安装 https://git-scm.com/downloads 一直点下一步就可以,安装完后打开方法:‘开始菜单’-->'Git'-->''Git Bash 安装完成后设置名字和电子邮件 bash基本操作 1).cd : 改变目录. 2).cd . . 回退到上一个目录,直接cd进入默认目录 3).pwd : 显示当前所在的目录路径. 4).ls(ll): 都是列出当前目录中的所有文件,只不过ll(两个ll)列出的内容更为详细. 5).touch : 新建一个文件 如 touch index…
-------------------------------------知识是一点一点的积累的, 也是一点一点的吸收的,没有人一口就能吃成一个胖子. 版本控制 说到版本控制,脑海里总会浮现大学毕业是写毕业论文的场景,你电脑上的毕业论文一定出现过这番景象! 1 2 3 4 5 6 7 8 9 10 11 毕业论文_初稿.doc 毕业论文_修改1.doc 毕业论文_修改2.doc 毕业论文_修改3.doc 毕业论文_完整版1.doc 毕业论文_完整版2.doc 毕业论文_完整版3.doc 毕业论文…
1.Mac中使用Git上传项目代码时忽略.DS_Store文件 简单的说Mac每个目录都会有个文件叫.DS_Store,它是用于存储当前文件夹的一些Meta信息.所以每次查看Git目录的状态,如果没有add这个.DS_Store文件,会有Untracked files:的提示,add了它,又会常有Changes not staged for commit:的提示,要解决这个烦人的小妖精,我们需要用到.gitignore文件去配置Git目录中需要忽略的文件. touch .gitigonre若当前…
git提交的时候一直提示 e/.idea/workspace.xml文件冲突, 这个文件是IDE编辑的时候自动带的文件,这个文件在提交的时候是不需要上传到git中的 这个时候我们需要这种.gitignore<\a>文件规避不需要的文件 在根目录下创建.gitgnore文件 touch .gitignore 在.gitignore文件中提交需要屏蔽的文件.gitignore&lt 虽然加入了.gitignore文件,但是在项目开发过程中,上述方法定义后发现并未生效,原因是.gitigno…
协同开发 1.引子:假如三个人共同开发同一份代码,每个人都各自安排了任务,当每个人都完成了一半的时候,提交不提交呢? 要提交,提交到dev吗,都上传了一半,这样回家拿出来的代码根本跑不起来.所以, 为每一个人创建一个分支,各自都在各自的分支上写代码,互不影响. 很短时间内大家暂时先合并一次,不然冲突太多了.但是这个分支不是dev,而是review分支,当老大看完没问题之后再合并到dev分支. 协同开发的两种方式: 方式一:创建项目合作者: 码云: github: 方式二:创建组织,邀请成员 码云…
转自:https://www.cnblogs.com/wupeiqi/p/7295372.html 版本控制 说到版本控制,脑海里总会浮现大学毕业是写毕业论文的场景,你电脑上的毕业论文一定出现过这番景象! 1 2 3 4 5 6 7 8 9 10 11 毕业论文_初稿.doc 毕业论文_修改1.doc 毕业论文_修改2.doc 毕业论文_修改3.doc 毕业论文_完整版1.doc 毕业论文_完整版2.doc 毕业论文_完整版3.doc 毕业论文_最终版1.doc 毕业论文_最终版2.doc 毕业…
目录:GIT其他篇 01: git & github 02: git分支管理 目录: 1.1 常见版本管理工具介绍 及 版本工具作用 1.2 git.GitHub和SVN比较 1.3 本地git基本使用命令 1.4 使用git操作GitHub 1.5 配置win10当前用户对GitHub所有项目有权限(git push不必输入密码) 1.6 配置Linux当前用户对GitHub指定项目有权限(git push不必输入密码) 1.7 git分支管理(创建&合并分支) 1.8 git stas…
有些时候,你必须把某些文件放到Git工作目录中,但又不能提交它们,比如保存了数据库密码的配置文件啦,等等,每次git status都会显示Untracked files ...,有强迫症的童鞋心里肯定不爽. 好在Git考虑到了大家的感受,这个问题解决起来也很简单,在Git工作区的根目录下创建一个特殊的.gitignore文件,然后把要忽略的文件名填进去,Git就会自动忽略这些文件. 不需要从头写.gitignore文件,GitHub已经为我们准备了各种配置文件,只需要组合一下就可以使用了.所有配…
简介 就是普通的.gitignore # Byte-compiled / optimized / DLL files __pycache__/ *.py[cod] *$py.class # C extensions *.so # test module 个人习惯,测试目录去掉 /test/ # Distribution / packaging .Python build/ develop-eggs/ dist/ downloads/ eggs/ .eggs/ lib/ lib64/ parts/…
1 当日内容概要 2 内容回顾 3 Git版本控制之多人协同开发 4 Git版本控制之fork 5 版本控制之其他 6 Redis之字典基本操作 7 Django中操作Redis 8 Django缓存 9 小补充:Rest Framework访问频率限制 1 当日内容概要 1.1 Git : 1.2 Redis: 1.3 修改代码: 2 内容回顾 2.1 Git: 2.1.1 Git开发时候,出Bug之后如何解决? 2.1.2 Git rebase的作用?不出现分叉! 2.1.3 Git的操作命…
问题: 提交项目的时候忘记添加.gitignore文件,误上传了文件(如.idea)如何解决?(本文以.idea文件夹举例) 1.将项目文件拉取下来 git pull origin master 2.添加需要过滤的文件 a. 如果你有.gitignore文件,但是没添加误上传的文件夹(如.idea) 新起一行添加 .idea/ b. 如果你没有.gitignore文件,在你的项目里创建一个.gitignore的文件 将下面的文本放入即可 通用.gitignore文件 # Initially ta…
echo "# test" >> README.md git init git add README.md git commit -m "first commit" git remote add origin https://github.com/jiujue/wesigdemo.git git push -u origin master …or push an existing repository from the command line   gi…
1.创建git文件模式 https://www.cnblogs.com/wupeiqi/p/7295372.html  参考地址 先看这个 初始化仓库 git init      在本地新建一个repo,进入一个项目目录,执行git init,会初始化一个repo,并在当前文件夹下创建一个.git文件夹. 查看仓库当前的状态 git status      查询repo的状态.      git status -s: -s表示short, -s的输出标记会有两列,第一列是对staging区域而言…
目录 文章目录 目录 前言 RPM 打包环境安装 RPM 打包流程 OpenStack RPM SPEC Sample RPM 升级/回退 前言 软件功能升级,尤其是 Python 这类解析型语言的软件功能升级方式一般可以选择直接打 git patch,但这种方式再生产环境中肯定是不够专业的,所以即便是一个小功能,涉及到几个模块的代码改动,还是建议以 RPM 包的方式进行升级.全量升级或者 RPM 冗余,但比增量升级更为可靠. RPM(Red Hat Package Manager,Red Ha…
准备工作 项目创建完成后,将项目版本控制起来,今后每个版本的迭代会非常清楚,同时也有助于项目进行协同开发. 还有一个十分重要的问题是:项目上线后,线上的运行的程序的配置与线下进行测试的配置文件是不一样的(比如数据库的配置.DEBUE模式.ALLOWED_HOSTS等等),因此我们这里需要为线下的测试环境新建一个单独的测试文件local_settings.py, local_settings.py文件的内容如下: # -*- coding:utf-8 -*- # 本地的settings 不用版本控…
希望在readthedocs上创建支持多语言的文档,效果类似: 通过语言选项,可以切到到不同的语言版本:实现这个目标包含两个主要步骤: 在本地对文档进行翻译 在readthedocs.org上配置翻译 本文假设您已经对sphinx文档生成工具和readthedocs.org文档托管网站有所了解,本文主要专注于多语言的配置上. 在本地对文档进行翻译 翻译之前需要安装一些软件包: sphinx: 文档生成工具 sphinx_intl: 多语言工具 recommonmark: sphinx支持mark…
Git 忽略文件提交的方法 有三种方法可以实现忽略Git中不想提交的文件. 在Git项目中定义 .gitignore 文件 这种方式通过在项目的某个文件夹下定义  .gitignore 文件,在该文件中定义相应的忽略规则,来管理当前文件夹下的文件的Git提交行为. .gitignore 文件是可以提交到公有仓库中,这就为该项目下的所有开发者都共享一套定义好的忽略规则. 在  .gitingore  文件中,遵循相应的语法,在每一行指定一个忽略规则.如: *.log *.temp /vendor2…
gitignore文件 python .gitignore .idea/ *.bak test* logs/ *.log # *.txt # Byte-compiled / optimized / DLL files __pycache__/ *.py[cod] *$py.class # C extensions *.so # Distribution / packaging .Python build/ develop-eggs/ dist/ downloads/ eggs/ .eggs/ l…
问题: 提交项目的时候忘记添加.gitignore文件,误上传了文件(如.idea)如何解决?如何删除Gitee地址上项目的.idea文件?(本文以.idea文件夹举例) 拉取项目 拉取项目 git pull origin master 添加需要过滤的文件 a. 如果你有.gitignore文件,但是没添加误上传的文件夹(如.idea) 新起一行添加 .idea/ b. 如果你没有.gitignore文件,在你的项目里创建一个.gitignore的文件 将下面的文本放入即可 通用.gitigno…
参考:https://github.com/github/gitignore Python的.gitignore模板,记录一下方便查询 # Byte-compiled / optimized / DLL files __pycache__/ *.py[cod] *$py.class # C extensions *.so # Distribution / packaging .Python build/ develop-eggs/ dist/ downloads/ eggs/ .eggs/ li…
1. .gitignore常见项目添加 1.1 .gitignore模板 .gitignore针对每个语言都有对应的模板,在GitHub创建项目时就可以选择(你可以在GitHub提供的.gitignore模板大全中找到它).如Python语言的.gitignore模板如下: # Byte-compiled / optimized / DLL files __pycache__/ *.py[cod] *$py.class # C extensions *.so # Distribution / p…
前言: 使用Sphinx 生成文档和使用 Read The Docs 的 readthedocs/sphinx_rtd_theme,假设是在Windows上运行并已安装好 python,可以执行python的 pip命令 通过 pip命令安装 sphinx 和 sphinx_rtd_theme pip install -U Sphinx pip install sphinx-rtd-theme 在一个系统中的一个空的文件夹中运行: 如我在D 盘中新建了一个名字为 sphinx的文件夹 sphin…
这里是总结了一下,用的工具或者平台:readthedocs.github .sphinx. 使用这三个工具即可轻松创建高效的文档管理库,可以用来翻译,水平再高一点可以写书. readthedocs 文档托管的平台,能够和常用的GIT阵营的github,HG阵营的Bitbucket,关于这两个平台的讨论比较文章可以参考. github 代码托管 sphinx 文档书写利器,使用的是reStructuredText格式,reStructuredText简明教程. 下面说说书写方法及托管流程 在这里注…
1. Introduction 1.1. About 1.2. Sphinx features 1.3. Where to get Sphinx 1.4. License 1.5. Credits 1.6. History 2. Installation 2.1. Supported systems 2.2. Compiling Sphinx from source 2.2.1. Required tools 2.2.2. Compiling on Linux 2.2.3. Known comp…