它使用 Sphinx 生成 html 静态页面,通过 github 账户授权,在本地项目 push 到 github 仓库时,自动完成文档的生成和在线更新。...给已有项目添加文档 以笔者真实托管在 GitHub 上的项目 imgkernel 为例。读者以自己实际项目对相关部分做修改,下文不再单独讲述。...3.1 在项目根目录创建 docs 目录 克隆项目: git clone https://github.com/kenblikylee/imgkernel.git cd imgkernel 创建并切换到...docs 分支: git checkout -b docs 创建子目录 docs: mkdir docs 3.2 使用 sphinx-quickstart 初始化文档 进入 docs 目录中,运行命令...Read the Docs” 会重新拉取分支 docs,构建生成 html 。构建需要一点时间,构建完成后,点击页面主页右边的绿色按钮 【阅读文档】,即可打开最终我们需要的在线文档的地址。
# 进入文档创建选项过程 进入文档创建选项过程之后,按照自己的需求来选择具体选项。...(s): chenxiaowu > Project release []: 0.1 > Project language [en]: zh_CN 完成这些选项之后,在/data/testdocs目录下就会创建一个文档项目...编写第一个文档 现在开始就可以创建真正的文档了,具体需要3步: 1.在source目录下创建一个.rst的文件,如:hello.rst2.文件内容为rst格式文本3.修改source/index.rst...make html 想要访问生成后的html内容,可以通过/data/testdocs/build/html/index.html路径来查看。默认的效果如下: ?...除了默认html模板外,你当然可以自定义模板了;除此之外还有一个比较流行的模板 -- readthedoc官网使用的模板。其配置方式只要修改一下source/conf.py文件即可。
于是粗率的学习了下sphinx ---- Sphinx 是用 Python 编写的,并且最初是为 Python 语言文档而创建,但它并不一定是以语言为中心,在某些情况下,甚至不是以程序员为中心。...zh-sphinx-doc.readthedocs.org/en/latest/invocation.html#sphinx-apidoc 安装readthedocs主题 # pip install sphinx_rtd_theme...编辑conf.py import sphinx_rtd_theme html_theme = "sphinx_rtd_theme" html_theme_path = [sphinx_rtd_theme.get_html_theme_path...: http://zh-sphinx-doc.readthedocs.org/en/latest/invocation.html 自定义生成文档的类或方法 Domain.py源代码: class domains..., 返回所有的域名列表 ip 合法的ipv4或ipv6的值, 返回解析是此IP的记录列表 domain 完整的域名格式(记录 + 域名
创建仓库 首先,我们需要在GitHub上创建仓库并将该仓库克隆到本地,当然你也可以直接在原有仓库上进行操作。 ?...注册账号并连接到GitHub 接着我们需要在ReadtheDocs官网注册一个账号,https://readthedocs.org/ ,注册成功后在设置中选择已连接的服务,并点击Connect to GitHub...项目导入 在个人面板点击Import a Project,选择需要创建文档的项目,若是未找到目标项目,可以点击右上角的刷新并等待。 ?...构建文档 导入项目之后,我们点击Build version即可成功创建文档 ? 等待片刻后即可构建完成,Webhook自动添加之后只要更新GitHub仓库,项目文档就会自动重新构建。 ?...import sphinx_rtd_theme html_theme = "sphinx_rtd_theme" html_theme_path = [sphinx_rtd_theme.get_html_theme_path
尝试从下面几个步骤讲解文档如何编写: reStructuredText 对比 markdown markdown 同样也是在程序员圈子里比较受欢迎的标记语言,大大减轻了编写文档的难度,reStructuredText...将 rst 格式的文件转换成 html 等格式的文件,方便托管在服务器上,进行访问,依赖的工具有:sphinx sphinx 介绍 sphinx 是一个基于python的文档生成工具,许多 python...在 SUMMARY.md 文件中构造目录结构 比如创建两个章节: # Summary ## one * [Introduction](README.md) * [Chapter1](chapter1...,类似于 gitbook SUMMARY.md _build 文件夹是文档运行后的结果存放目录 4....执行 make html 进行编译和预览,没报错后, 在 _build 文件下 html 文件夹下 index.html 用浏览器打开`, 结果如下: E:\gerrit\docs_rst (env35
Develop 分支,并进入下一个 Release Release 分支 当需要发布一个新 Release 的时候,基于 Develop 分支创建一个 Release 分支,完成 Release 后,...合并到 Master 和 Develop 分支 Hotfix 分支 当在 Production 发现新的 Bu g时候,需要创建一个 Hotfix, 完成 Hotfix 后,合并回 Master 和 Develop...如图每个工程都共享一个 version 版本号,分支创建分为版本升级、特性更新、修订补丁三种模式,强制项目所有分支创建的命名规则都会升级,不会出现重复跟降级。 ?...具体修复的是哪个版本的问题 上述流程的缺点: 固化版本流程导致创建命名规则固定,且版本号不能升级只能降级 流程限制,降低开发灵活性 没有完美的解决方法,所有 devops 流程都要结合真实项目需求来设计...ctx.body.detail = err.errors; } ctx.status = status; } }; }; 如上,我们拓展默认错误类,添加错误中间件拦截全局异常,如果出现自定义异常抛出的时候
简介 Sphinx 是一种文档工具,它可以令人轻松的撰写出清晰且优美的文档, 由 Georg Brandl 在BSD 许可证下开发....我们需要在终端中输入下列命令进行安装: pip install sphinx 创建Sphinx项目 创建一个用于存放文档的文件夹,然后在该文件夹路径下运行下列命令快速生成Sphinx项目: sphinx-quickstart...pip install recommonmark pip install sphinx_rtd_theme 安装好,在conf.py中修改下列两个配置: source_suffix = ['.rst'...'.MD': CommonMarkParser, } 生成文档 在Sphinx项目所在的文件夹路径下运行下列命令生成文档: make html 生成后的文档位于build/html文件夹内,...用浏览器打开index.html即可看到生成后的文档。
函数function (1).函数命名规范 (2) . 函数返回值 (3). 参数 (4). 变量作用域 (5). 静态变量 (6). 自定义函数 7....则被称之为未定义变量,该变量会报错....> 6.多重循环 多重循环: 在循环中 嵌套循环 7.流程控制符 break 立马结束分支/循环,准备执行分支/循环外的代码 continue 立马结束当前一轮的循环,准备进行下一轮循环....( ){ } 下划线命名法 function add_user_name( ){ } 函数名不能重名 function var_dump(){ } 函数名不能重名包括系统函数和自定义的函数...在函数内部调用自己 2. 在执行后,最终会返回到最初的地方 3.
通过这篇文章,我们可以对UB 有更深入的理解。 “PL 和AI是计算机科学的两大学科分支。...例如,在CPU的指令集说明中可能将某些形式的指令定为未定义,但如果该CPU支持内存保护,说明中很可能会还会包含一条兜底的规则,要求任何用户态的指令都不会让操作系统的安全性受损;这样一来,在执行未定义行为的指令时...一个符合标准的实现可以在假定未定义行为永远不发生(除了显式使用不严格遵守标准的扩展)的基础上进行优化,可能导致原本存在未定义行为(例如有符号数溢出)的程序经过优化后显示出更加明显的错误(例如死循环)。...*x1 = 0; // 未定义行为! 这段代码有 UB 的原因不难看出来,通过裸指针创建了两个可变借用互为别名。...提议:"未定义行为 "可能需要重新命名。这个术语关注的是负面情况,而作为程序员或编译器作者,我们真正关心的是程序没有未定义行为。我们能摆脱这种双重否定吗?
对象主要有两种: 原生的(Native) 原生的对象分为内置对象(数组,日期等) 和用户自定义对象 (var o={}) 主机的(Host) 包含windows对象和所有的DOM...该对象几乎等同于采用对象字面量或Object()创建的对象,区别在于它的constructor属性指向了所创建的函数,而不是指向内置的Object()函数。...:能否删除 使用var创建的全局变量(这类变量在函数外部创建)不能删除 不使用var创建的隐性全局变量(尽管是在函数内部创建)可以删除 这表明隐含全局变量是全局对象的属性,属性可以通过delete操作符删除.../过滤 console.log(i,":",man[i]); } } 使用hasOwnProperty对man对象进行精炼后,可以避免命名冲突,也可以使用一个本地变量来缓存比较长的属性名。...分号插入机制 semicolon insertion mechanism 空格 命名约定 构造函数的首字母大写 分割单词 构造函数可以用使用大驼峰命名法 函数和方法名可以用小驼峰命名法 函数的变量可以用小写单词和下划线连接
目录 Javascript快速入门(一) 变量的命名规则 变量与常量 变量 常量 数据类型 数值型:Number 字符串:String 常用方法: 布尔类型:Boolean 未定义类型 :Undefined...myAge 变量命名要见名知意 命名示例 // 正确的命名 age myAge init finalOutputValue audio1 //错误和不规范的命名 1a_12 MYAGE var...let在ECM6中可用,可能在较低的版本中无法正常使用,pycharm在使用上述关键字的时候如果出现了报错说明js版本没有选择6 需要我们自定义设置 //变量示例 var name = 'Hammer...'abcd'.charAt(2) c indexOf() 检索指定的字符串值在字符串中首次出现的位置 'abcd'.indexOf('a') 0 lastIndexOf() 从后往前查询所要搜索的字符串在原字符串中第一次出现的位置...is1 = true; var is2 = false; 未定义类型 :Undefined 未定义的意思就是只声明不定义,没有值,规范的来说是缺省 var a; console.log(a); //
分派时收到的任何事件 源被挂起或事件处理程序块当前正在执行时 是在调派源恢复后还是在 事件处理程序块已返回。 调度源是在非活动状态下创建的。...在创建了 来源和设置任何想要的属性(例如,处理程序,上下文等),为了开始事件传递,必须调用dispatch_activate()。...在事件处理程序回调之外调用此函数的结果是 未定义的。在这个参数中传递NULL的结果是未定义的。...在这个参数中传递NULL的结果是未定义的。...要取消的调度源。在这个参数中传递NULL的结果是未定义的。
语句,默认策略的表现为:表名及字段全小写,并以下划线分隔 此外,引入的 Hibernate 还提供了另外一种物理命名策略,先进行如下配置,再来观察结果: spring: datasource:...物理命名策略,未定义 @Table 和 @Column 将以实体名和属性名作为表名及字段名 physical-strategy: org.hibernate.boot.model.naming.PhysicalNamingStrategyStandardImpl...,但如果有定义 @Table 和 @Column ,则以该属性值进行映射命名 当然,某些场景下,可以通过自定义命名策略来简化操作,或实现自身特定的业务,例如:假设需要为未定义 @Table 实体加上表前缀...(0))) { // 大写字母下划线分隔命名策略,有在实体字段上自定义@Column(name="Xx_Xxx") return new Identifier...自定义的命名策略 physical-strategy: cn.mariojd.jpa.naming.config.CustomNamingStrategyConfig 启动项目,查看结果
要从主分支的a /docs文件夹中发布站点的源文件,您必须拥有一个主分支,您的存储库必须: 在存储库的根目录中有一个/docs文件夹? 不遵循存储库命名方案.github。...定制的404s只有在使用自定义域时才会起作用。否则,将使用用户页404。 使用命令行创建项目页面。 如果您熟悉命令行Git,那么手动创建项目页面站点是很容易的。...做一个新的克隆 要设置项目页面站点,您需要创建一个新的“孤儿”分支(在您的存储库中没有与现有分支有共同历史的分支)。...*分支名称 *分支名称 如果您还没有在您的存储库中拥有一个主分支,那么创建一个新的主分支: git checkout,孤儿的主人 #创建一个主分支,没有任何父母(它是一个孤儿!)...加载新的GitHub页面站点。 在您推送到主分支后,您的项目页面站点将在“http(s)://.github”上可用。io / ”。
当我们在一个文件中使用多个类,就会用到类的自动加载,在开发中,一个类对应一个文件,命名方式为类名.class.php,通过include或require引入 当使用一个未定义的类时,就会自动触发__autoload...2.对代码优化,使用类的自动加载 ? 3.对代码进一步优化,更灵活 创建一个common.php文件,把类名和路径的映射关系数组定义好 ? <?.../Cat.class.php'; //类的自动加载完成 /* @function 完成类的自动加载 @param $class_name 是类的名称 @说明:当使用一个未定义的类时,就会自动触发__autoload...$class_name.'.class.php'; // } //不同的文件夹下的类,进行自动加载 require '....> 4.使用spl_autoload_register 高级方式完成类的自动加载 spl_autoload_register可以灵活的注册自己的自动加载函数,就是可以自定义自动加载函数 案例: ?
查看分支 3. 创建分支 4. 删除分支 5. 重命名分支 6. 设置上游分支 7. 将分支推送到远程仓库 1....前言 git branch 用于查看、创建、删除分支、重命名分支,通过不同的命令参数实现相应的功能 2....创建分支 以当前分支为起点,创建一个 dev 分支【使用前提: 当前分支已有提交记录】 git branch dev 可以使用 git checkout -b 创建并切换到新的分支 # 创建并切换到新分支...(本地分支不会被删除) # 普通写法 在代码托管平台删除了分支,本地仓库该分支还存在,执行下面两个命令中的任意一个都可以解决: git fetch --prune 5....> 使用场景 1 : 重命名未上传到远程仓库中的分支 # 先切换到 dev 分支,然后再重命名 使用场景 2 : 重命名已经上传到远程仓库中的分支 # 将远程仓库中的 dev 分支签出到本地 (签出并切换到
简介AutoGPT是Github上的一个免费开源项目,结合了GPT-4和GPT-3.5技术,通过API创建完整的项目。...,我们要克隆的是stable分支而不是master分支,因为master分支可能会存在着不稳定的问题。...搜索“自定义搜索API”并单击它,然后单击“启用”转到凭据页面,然后单击“创建凭据”。选择“API 密钥”复制 API 密钥并将其设置为计算机上命名的环境变量。在项目上启用自定义搜索 API。...转到自定义搜索引擎页面,然后单击“添加”。按照提示设置搜索引擎。创建搜索引擎后,单击“控制面板”,然后单击“基本信息”。复制“搜索引擎 ID”并将其设置为计算机上命名的环境变量。...修改.env.template配置文件 ,在Auto-GPT文件夹中,找到该文件,接下来复制该文件并将其后缀重命名为.env结尾打开项目,配置项目环境,同时运行pip命令安装所需的库`pip install
before_script 覆盖作业之前执行的一组命令。 after_script 覆盖作业后执行的一组命令。 stage 定义一个作业阶段(默认值:)test。 only 限制创建作业的时间。...if: '$CI_COMMIT_BEFORE_SHA == '0000000000000000000000000000000000000000' 在没有提交的情况下创建或推送新分支时,允许或阻止管道创建...您可以在Shell变量甚至自定义环境变量中定义颜色代码,这使命令更易于阅读和重用。...为了避免在创建分支而未进行任何更改时运行管道,请检查的值$CI_COMMIT_BEFORE_SHA。...(在结束符后附加正则表达式标志/。)因此issue-/.*/无法匹配以开头的所有标记名或分支名issue-。
throw抛出的最基本的接口,但是PHP不允许直接实现这个接口Exception所有用户级异常的基类,想要自定义异常就可以继承这个LogicException代码逻辑错误,就是代码写的不对BadFunctionCallException...如果回调函数未定义或缺少参数的时候,抛出这个异常BadMethodCallException如果回调方法未定义或缺少参数的时候,抛出这个异常DomainException如果一个值不在有效的值列表中,则抛出这个异常...溢出RangeException执行期间的范围异常,相当于编译期间的DomainExceptionUnderflowException空对象上的无效操作,eg: 删除元素UnexpectedValueException...AssertionError断言失败错误CompileError编译错误ParseError解析PHP代码错误ValueError传值错误UnhandledMatchErrormatch未被匹配到任何分支...FiberError在纤程上执行无效操作
领取专属 10元无门槛券
手把手带您无忧上云