https://zhuanlan.zhihu.com/p/22663276?refer=passer http://zh-google-styleguide.readthedocs.io/en/latest/google-python-styleguide/python_style_rules/…

在 python改变世界,从hello world开始 中我们已经完成了第一个python程序,代码是有了,关键是好像好不知道写的啥玩意? 一.什么是代码注释 代码注释就是给一段代码加上说明,表明这段代码的作用或者实现的功能,方便别人阅读代码.打个形象的比喻: 问题来了,那个女孩是谁?张三?李四?王五? 加上注释再来一遍:放开小红.大家就都明白了,这个女孩叫小红. 二.为什么写代码要注释 IT圈有一个梗:当我写这段代码的时候,只有上帝和我知道,现在,只有上帝知道.上帝说:这个锅我不背!   IT…

最近看了不少代码,也写了不少代码,所以在看和写之间发现了很多的问题,真的是很多,至少从我的认识来看,有几个地方有很大的改进空间,这里不准备把所有的问题都列举出来,所以就先挑选一个比较明显得来和大家聊聊.回顾流行开源项目的成功,除了功能上的刚需之外,文档也是必不可少的一个环节,没有良好文档的开源项目几乎不可能说是流行的,因为很少人会因为你说了一句使用我的项目就可以怎么怎么样就傻不溜秋得用你的.从我以前开源的项目中大家可能会发现一个比较大的问题就是文档工作做得确实不咋地. 项目中的文档我认为可以分为…

对某些代码进行标注说明,增加程序的可读性. 一.单行注释 以“#” 开头,#后面的所有东西都不会被运行 print("hello python") # 输出 `hello python` 二.多行注释 需要注释的内容有多行时,就需要用多行注释,由三对 引号 构成 """ 这是一个多行注释 在多行注释之间,可以写很多很多的内容…… """ print("hello python")…

安装 使用pip进行安装: pip install sphinx 初始化 进入你代码所在的目录,输入: sphinx-quickstart 下图:PRD是代码所在目录,生成的文档保存目录设成doc  下图:设置项目名称与作者,项目名称之后会作为标题显示在文档首页  下图:基本一路默认  下图:到此,生成doc文件夹  配置修改 进入此文件夹找到conf.py文件,打开编辑,将下面几行代码(第19-21行)取消注释: 并修改代码为: 生成 rst 到代码目录,执行以下命令,会生成对应 python…

1.单行注释使用# # Code 2.多行注释,成对使用'''或""",三个单撇号或三个双引号 “”” Code “”” 3.多行快捷注释 1).增加注释 选中待注释的多行,按Ctrl+/ 2).取消注释 选中待取消注释的多行,按Ctrl+/…

引言王者荣耀大家都玩过吧,没玩过的也应该听说过,作为时下最火的手机MOBA游戏,咳咳,好像跑题了.我们今天的重点是爬取王者荣耀所有英雄的所有皮肤,而且仅仅使用20行Python代码即可完成. 准备工作爬取皮肤本身并不难,难点在于分析,我们首先得得到皮肤图片的url地址,话不多说,我们马上来到王者荣耀的官网: 我们点击英雄资料,然后随意地选择一位英雄,接着F12打开调试台,找到英雄原皮肤的图片地址: 接着,我们切换一下英雄的皮肤,会发现图片地址没有明显的变化,只是最后的数字序号改变了,我们将两个皮…

用Sphinx自动生成python代码注释文档 pip install -U sphinx 安装好了之后,对Python代码的文档,一般使用sphinx-apidoc来自动生成:查看帮助mac-abeen:doc_logic abeen$ sphinx-apidoc --helpUsage: sphinx-apidoc [options] -o <output_path> <module_path> [exclude_path, ...] Look recursively in &…

实现我们分类数字的网络 好,让我们使用随机梯度下降和 MNIST训练数据来写一个程序来学习怎样识别手写数字. 我们用Python (2.7) 来实现.只有 74 行代码!我们需要的第一个东西是 MNIST数据.如果有 github 账号,你可以将这些代码库克隆下来, git clone https://github.com/mnielsen/neural-networks-and-deep-learning.git 或者你可以到这里 下载. 顺便说一下, 当我先前说到 MNIST 数据集时,我说…

一直在Coursera上补基础课,发现很多课程都用Python作为教学语言,学了一下感觉果然好,简直是用英语在写代码.(我建Python目录的时候发现去年学过一点点Python,居然一点都不记得了= =) 不过注释的问题很少有课程给你讲清楚. 原来的了解是:Python的注释有2种,#是单行,'''是多行.昨天看了A Byte of Python才知道'''并不是严格意义上的注释,而是多行字符串,只不过当注释用的时候,反正没人用到,也就不会有作用. 不知道还好,知道以后心里就有疙瘩,放狗搜了一下…