在《为tinycolinux创建应用包》中我们用简单解压组合tcz的方式组建了一个lnmp环境包(mysql5.1+php5.3),在这里,我们准备为tinycolinux建立一个toolchain环境...请下载tinycolinux live hd一体包后继续: 组建bootstrap toolchain ----- 以下tcz默认全是4.x的,从4.x的compiletc.tcz的meta包的dep中提取而来...,以下底部部分eglibc_base-dev就是glibc开发包,glibc runtime已经在tinycolinux的/lib中了,底部其它的那些是可选开发包,因为比较基础都保留了,gcc为461版本.../configure --prefix=/usr/local/nginx 以上编译过程中,如果解压发现不了实际已解压的引用包的,一般是一些含.so的包,需要sudo reboot重启一次guest系统...其实大多数可以参照《为tinycolinux创建应用包》中的做法,但还有一些附加处理部分: mysql中新建一个tmp用来放mysql.sock,其权限要和data一样,都设为0755且归staff下的
本教程为整个数据库表进行创建迁移,弥补以前未做的工作,且仅适合于Migrations(2.0.8)版本用户及以上。...使用Migrations命令创建迁移的时候,命令会询问我们是否需要创建,填写y 或 n,那么我们既然要批量创建,肯定是不能允许这种阻止程序的事情发生,在502行,有个if判断$this->confirm...value为表名,然后我们使用php的 exec 函数执行命令,这命令的意思是,创建迁移文件,文件名是以:create_表名 形式拼接好的,$info 可以输出打印调试结果,执行成功将会返回 New...这个时候:console/migrations/ 目录下会创建迁移文件,成功创建完迁移文件之后,我们将所有表删除掉(删除之前记得备份!备份!!备份!!!)...如果报表已存在的错误的话,那么就是你没有将表删完,Migrations创建迁移 跟 其他操作的时候,会自动新增一张为 migrtions的表,这张表是记录的。
Go项目对此理念推崇备至,于是我们有了神器——Godoc。 正文 Godoc的工作原理 Godoc不仅解析Go源码,还包括注释,并生成HTML或纯文本文档。...例如,通过Godoc的Web界面,你可以从函数的文档跳转到其实现上,只需要一次点击。 为你的项目写文档 Godoc鼓励开发者在声明之前直接写下普通的注释来文档化类型、变量、常量、函数或包。...遗留代码与弃用警告 当一个结构体字段、函数、类型或整个包变得多余或不必要时,为了保持向后兼容性,需要保留它们。在文档注释中添加“Deprecated:”段落,以指示不应再使用该标识符。...Godoc注释的格式化规则 连续行的文本被视为同一段落;需要留空行来分隔段落。 预格式化的文本必须相对于周围的注释文本缩进。 URLs将自动转换为HTML链接。...任何安装在$GOROOT/src/pkg内的Go包以及GOPATH工作空间中的代码都可以通过Godoc的命令行和HTTP接口访问。 总结 Godoc工具展示了Go语言对文档化的重视。
本文章的目的是通过例子,简要说明 GoDoc 的格式,让读者也可以自己写一段高大上的 godoc。以下内容以我自己的 jsonvalue 包为例子。其对应的 GoDoc 在这里。...---- pkg.go.dev 内容 总体内容 由于笔者在 jsonvalue 中对 GoDoc 玩得比较多,因此还是以这个库为例子。...,取的是 go 代码中的 “包注释” 部分 Index 这是整个 GoDoc 内容的总目录,包含了所有可导出的函数、方法、常量、变量和示例代码 Variables 这里列出了所有可导出变量。...Overview 部分 在 Documentation 中的 Overview 部分,是整个 package 的说明,这种类型的注释,被称为 “包注释”。...有 html 和 markdown 格式任君选择。
以下内容以我自己的jsonvalue(https://github.com/Andrew-M-C/go.jsonvalue)包为例子。...浏览器的地址与godoc类似,但是少了“pkg/”,页面如下图所示: 四、pkg.go.dev内容 (一)总体内容 由于笔者在jsonvalue中对GoDoc玩得比较多,因此还是以这个库为例子。...六、Overview部分 在Documentation中的Overview部分,是整个package的说明,这种类型的注释,被称为“包注释”。包注释是写在go文件最开始的package xxx上面。...此时,GoDoc提供了一个关键字Deprecated:,作为整个注释块的第一个单词,比如我们可以这么写: // Deprecated: ElemAt 这个函数弃用,后续请迁移到 IntsElem...有html和markdown格式任君选择。
go doc template.new Show documentation for html/template's New function....复制代码 而godoc 是一个文档生成工具,通过解析项目.go文件中包含注释的,来生成HTML或文本类型的文档 。通过在本地启动一个web程序,可以在浏览器来展示项目的文档。...Godoc将使用注释的文本来形成包的文档(粒度是某个package,而不是具体到某个.go文件) 官方介绍 Godoc: documenting Go code Go 1.5之前godoc也是一个内置的命令...:6060 -play -index 或 简写为 godoc -http=:6060 -play -index 然后再访问 http://localhost:6060/,如下: 添加 -play选项是选择是否开启...这个索引会在服务器启动时创建并维护。
本文章的目的是通过例子,简要说明 godoc 的格式,让读者也可以自己写一段高大上的 godoc。以下内容以我自己的 jsonvalue 仓库为例子。其对应的 godoc 在这里。...我们可以用下面的命令在本地启动自己的 godoc 服务: godoc -http=127.0.0.1:6060 -play 或者简写为: godoc -http=:6060 -play 在浏览器输入 http...在 godoc 中,文档包含三大部分: 组成 作用 Overview 总览 包含包的 import 语句和概要说明 Index 目录 包含包中可见性为 public 的常量、类型、方法、函数的总目录及说明...这一行,godoc 视为普通文字;而其余部分的左边为:两个斜杠 + 一个空格 + 一个tab,被 godoc 视为代码部分。...有 html 和 markdown 格式任君选择。 [6kdd2fbcv4.png] --- 本文章采用 知识共享署名-非商业性使用-相同方式共享 4.0 国际许可协议 进行许可。
如果包的名字是main, go build将调用连接器在当前目录创建一个可执行程序;以导入路径的最后一段作为可执行程序的名字。...$ go doc go/build 包文档 Go语言的编码风格鼓励为每个包提供良好的文档。包中每个导出的成员和包声明前都应该包含目的和用法说明的注释。...如果注释后仅跟着包声明语句,那注释对应整个包的文档。包文档对应的注释只能有一个(译注:其实可以有多个,它们会组合成一个包文档注释),包注释可以出现在任何一个源文件中。...第二个工具,名字也叫 godoc,它提供可以相互交叉引用的HTML页面,但是包含和 go doc命令相同以及更多的信息。...godoc的在线服务 https://godoc.org ,包含了成千上万的开源包的检索工具。 你也可以在自己的工作区目录运行godoc服务。
godoc利用函数、结构、包的注释生成文档。同时,可以利用一些约定的文件和函数命名方式,生成更细致的用例。非常方便也编译维护。...在package xxx,上方可以写包注释,格式为Package PACNAME ......。...添加用例 为函数、结构、整个包附带一些用例,可以丰富文档的内容。...PACNAME是包名。如example_try_test.go。这里要注意,package为PAC_test而不是PAC。...导出为markdown 利用工具gomarkdoc可将godoc导出为本地markdown。
目录 将当前的python环境的依赖包导出为txt文件 新建一个虚拟环境,将txt文件里面的依赖导入到新的虚拟环境里面 将当前的python环境的依赖包导出为txt文件 进入自己要导出依赖的虚拟环境...前面有括号就是进来了虚拟环境,如何创建虚拟环境 我们现在要将这个虚拟环境里面的依赖导出为txt文件 执行命令 pip freeze>package.txt ? ? ?...以上就导出了这个文件,你在哪个路径下执行的导出的命令,那么就在哪个路径下找txt文件 新建一个虚拟环境,将txt文件里面的依赖导入到新的虚拟环境里面 先进入你新创建的虚拟环境 之后在cmd里面到你放txt
public); 命名如果以小写字母开头,则对包外是不可见的,但是他们在整个包的内部是可见并且可用的(像面向对象语言中的 private ) 1、包命名:package 保持package的名字和目录保持一致...每个包都应该有一个包注释,在package子句之前有一个块注释。对于多文件包,包注释只需要存在于一个文件中,任何一个都可以。包评论应该介绍包,并提供与整个包相关的信息。...详细的如何写注释可以 参考:http://golang.org/doc/effective_go.html#commentary 1、包注释 每个包都应该有一个包注释,一个位于package子句之前的块注释或行注释...包注释应该包含下面基本信息(请严格按照这个顺序,简介,创建人,创建时间): 包的基本简介(包名,简介) 创建者,格式: 创建人: rtx 名 创建时间,格式:创建时间: yyyyMMdd 例如 util...// 创建人: hanru// 创建时间: 20190419 2、结构(接口)注释 每个自定义的结构体或者接口都应该有注释说明,该注释对结构进行简要介绍,放在结构体定义的前一行,格式为: 结构体名, 结构体说明
可以直接在命令行执行 go doc strings.Fields 获取库函数的解释;执行 go get golang.org/x/tools/cmd/godoc 会安装 godoc 工具,注意这两者是不同的...前者是 go 命令,后者则是 godoc 命令。...例如: go run a.go 10 1 os.Args 为 [/tmp/go-build059507490/b001/exe/cla 10 1] 关于 docker 的命令: # 根据 tag 创建...反射在实现 fmt, text/template, html/template 时是必须的。...通过 bytes 包[2]的例子,可以看懂 godoc 和源码[3]里的 comments 的对应关系。
前言 godoc的一些简记 命令 godoc的列表 | godoc的chm下载 查看godoc的所有命令 `$ godoc -h` usage: godoc -http=localhost:6060...See http://golang.org/lib/godoc/analysis/help.html -goroot string Go root directory (default...directory -timestamps show timestamps with directory listings -url string print HTML...string zip file providing the file system to serve; disabled if empty 建立本地官网 因为用命令看文档不是很方便,所以还是创建了一个本地的官网来查看文档...$ godoc -http=:8080 命令输入后是没有任何输出的,直接在浏览器上访问即可 chm下载 https://github.com/astaxie/godoc/downloads
在本章,我们将演示如何使用已有的包和创建新的包。 Go还自带了工具箱,里面有很多用来简化工作区和包管理的小工具。...其它一些包,可能只描述了单一的数据类型,例如html/template和math/rand等,只暴露一个主要的数据结构和与它相关的方法,还有一个以New命名的函数用于创建实例。...一旦go get命令下载了包,然后就是安装包或包对应的可执行的程序。我们将在下一节再关注它的细节,现在只是展示整个下载过程是如何的简单。...第二个工具,名字也叫godoc,它提供可以相互交叉引用的HTML页面,但是包含和go doc命令相同以及更多的信息。图10.1演示了time包的文档,11.6节将看到godoc演示可以交互的示例程序。...godoc的在线服务https://godoc.org ,包含了成千上万的开源包的检索工具。 你也可以在自己的工作区目录运行godoc服务。
需要安装的软件 golang1.12 安装包(到目前2019-06-09为止最新版本包) 下载地址 https://studygolang.com/dl 选择自己对应的操作系统 Go的开发工具 JetBrains...存放了在不破坏兼容性的前提下可能消失的一些api next.txt 存放了可能在下一个版本中出现的新的api特性 bin文件夹 存放go的可执行文件 gofmt.exe go官方的代码格式化工具,用来统一代码风格 godoc.exe...在不联网的情况下在本地访问go的api,windows下双击运行,在浏览器中访问 http://localhost:6060 go.exe 编译构建整个go项目,贯穿go项目的声明周期,go env...; go build; go mod; go install;等等 doc文件夹 存放Go语言几乎全部的HTML格式的官方文档和说明,方便开发者在离线时查看。...GOPATH 指定go项目依赖的第三方包存储路径,可以理解为Java中maven仓库路径,默认是C盘当前账户下创建一个go文件夹 ?
平时我们看 golang 文档的方式通常有: go doc golang.org/pkg 或者国内的 godoc.golangtc.com/pkg/ 看源码,当然这是最好的方式,只是需要更多的时间和耐心...后来了解到,godoc -html 可以生成 HTML 文档,所以就思考如何搭建本地的 localhost:3000/pkg 先取个名字,godocserver 步骤如下: 获取所有...golang built-in packages 名称 遍历所有 packages 运行 godoc -html 保存所有文件,启动一个静态文件服务器 利用 Ruby 实现 步骤1...、2,要注意遍历 $GOPATH/src/ 时要过滤一些不需要的目录,创建文件时,要先创建对应的目录。
近期,Go社区对其包和模块文档服务进行了一次重要迁移。现在,godoc.org的请求将被重定向到pkg.go.dev。如果你是Go语言爱好者,这肯定是个不容错过的消息!让我们一起深入了解吧!...这不仅是一个文档服务站点,还支持模块,提供了更好的搜索功能,以及帮助Go用户找到合适包的信号指标。...api.godoc.org会继续工作吗? 此过渡对api.godoc.org没有影响。在pkg.go.dev的API可用之前,api.godoc.org将继续服务。...如果你有兴趣为pkgsite项目做出贡献,可以查看贡献指南,或加入Gophers Slack上的#pkgsite频道了解更多信息。...gddo仓库 保持开放,标记为存档 api.godoc.org 继续运行,直到pkg.go.dev的API可用 贡献 欢迎为pkg.go.dev做出贡献 总结 这篇文章已被猫头虎的Go生态洞察专栏收录
See "JSON and Go" for an introduction to this package: https://golang.org/doc/articles/json_and_go.html...interface{ ... } type UnsupportedTypeError struct{ ... } type UnsupportedValueError struct{ ... } 以上是我们以json包为例...要想启动一个Web在线API文档服务很简单,使用godoc就可以了。...现在我们不管是用go doc,还是godoc都可以看到我们刚刚注释的文档了。...Add函数写的示例代码,我们运行godoc就可以看到结果了。
提供默认值 在设计函数和方法时,考虑为参数提供合理的默认值,以便用户在不传递参数时也能够顺利使用API。 创建自定义的Go语言API 在Go语言中,您可以创建自定义的API供其他程序调用。...提供公开的接口 通过将需要公开的函数、方法、类型等声明为首字母大写,使其可以被其他包导入和使用。...导入并使用 在其他Go程序中,通过导入您的包,即可使用您自定义的API。...您可以使用注释为函数、方法、类型等编写文档,并使用godoc工具生成文档网页。 1. 编写注释 在需要文档的地方,使用//注释格式编写文档。...无论您是在创建自己的库还是使用其他人的库,深入理解和掌握API的设计与使用,都将使您的代码更加强大和可维护,为您的项目带来更多的价值和成就。
,其实就是-n打印的执行版本 go fmt 有过C/C++经验的读者会知道,一些人经常为代码采取K&R风格还是ANSI风格而争论不休。...gofmt -w -l src,可以格式化整个项目。...$ go generate $ go build $ go test godoc 在Go1.2版本之前还支持go doc命令,但是之后全部移到了godoc这个命令下,需要这样安装go get golang.org...例如builtin包,那么执行godoc builtin 如果是http包,那么执行godoc net/http 查看某一个包里面的函数,那么执行godoc fmt Printf 也可以查看相应的代码,...执行godoc -src fmt Printf 通过命令在命令行执行 godoc -http=:端口号 比如godoc -http=:8080。
领取专属 10元无门槛券
手把手带您无忧上云