julycoding / The-Art-Of-Programming-By-July

本项目曾冲到全球第一,干货集锦见本页面最底部,另完整精致的纸质版《编程之法:面试和算法心得》已在京东/当当上销售

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

July:关于代码和图片重新命名的问题

julycoding opened this issue · comments

commented

首先,无论是优化后的C/C++代码,还是其它语言的代码,还是都放到这个文件夹下:ebook/code,这里说下代码命名的问题。

请大家不要再把代码名弄为chapter23.c之类的,因为最近目录在不断调整,可能原来是第23章,过两天后,原文就变成了第3.2节。

举个例子,如3.2:杨氏矩阵查找.c,之前是命名为chapter23.c,往后请一律找到现在目录对应的章节,暂命名为:3.2:杨氏矩阵查找.c,“现有目录:章节名字.c”,这样方便其他朋友把文章和代码一一对应起来,好阅读。

如还是不清楚,请参考C 代码的命名:https://github.com/julycoding/The-Art-Of-Programming-By-July/tree/master/ebook/code/c

故,照上述代码命名规范,烦请@liuyang1 改一下Python代码的命名:https://github.com/julycoding/The-Art-Of-Programming-By-July/tree/master/ebook/code/python ,其它语言Java、PHP、Go、JS、ruby、scheme的代码亦是如此,也都烦请重新命名下,thanks 各位。

这里的图片也都需要重新命名:https://github.com/julycoding/The-Art-Of-Programming-By-July/tree/master/ebook/images

如果需要文件夹(我看了下 Java 出现了文件夹,因为有时候定义了一些类;JavaScript 也需要,因为需要一个 test.html 和一个 tests.js 来执行测试),这个文件夹如何命名?
像这样?

/ 现有目录:章节名字
    - 现有目录:章节名字.js
    - test.html
    - tests.js

自己建立一個你的問題的子目錄不行嗎?比如 BoardTravelDP/ ,子目錄下你自己
怎麼折騰都行吧。如果是公共庫,可以考慮建設一個 code/java/common 之類的目錄

于 2014年03月24日 08:15, Frederick-S 写道:

如果需要文件夹(我看了下 Java 出现了文件夹,因为有时候定义了一些
类;JavaScript 也需要,因为需要一个 test.html 和一个 tests.js 来执行测
试),这个文件夹如何命名?


Reply to this email directly or view it on GitHub
#234 (comment).

@fairywell 我的意思和你一样,问题是,既然这里说到了命名规范,那么目录的命名规范是什么。

不知道兄弟说的是哪里提到的规范?上周讨论是说这周哪一个code style的初稿,
没有说道目录?

如果没有相应规范,frederick兄拿一个?

于 2014年03月24日 12:34, Frederick-S 写道:

@fairywell https://github.com/fairywell 我的意思和你一样,问题是,既
然这里说到了命名规范,那么目录的命名规范是什么。


Reply to this email directly or view it on GitHub
#234 (comment).

commented

@Frederick-S
你觉得怎样更好可以自己拿捏。

@fairywell ,咱们github上有这么多朋友,不是全部在北京,所以每周末参加编程艺术线下讨论的只能占极少数,所以咱们的讨论结果如果没有放在github上,其他人不会知道。
等咱们线下定了相关的规范后,再发个issue 好好讨论代码和命名规范的事。

@julycoding 我了解了,谢谢。

认领图片命名。是直接重命名,并且修改文章中相关图片路径吗?

commented

@chenrenyi
图片可以直接重新命名么,还是需要重新上传,然后再修改文中相关图片路径?

既然谈到了重命名,我重申下以前的一个观点:
任何文章、图片、代码、目录的名字中,都不带章节数字(如9.3xxx
2.5.4xxx.md),而采用类似 LCAProblem/ LCAProblem.c LCAProblem-pic-1 这样
的名字,最后只在目录中对这些内容作映射,是一种最佳的解耦方式。如果有内容
上和章节上的调整,只需要改动目录那一个文件即可。

FYI~~

于 2014年03月24日 14:51, July 写道:

@chenrenyi https://github.com/chenrenyi
图片可以直接重新命名么,还是需要重新上传,然后再修改文中相关图片路径?


Reply to this email directly or view it on GitHub
#234 (comment).

commented

@fairywell
“任何文章、图片、代码、目录的名字中,都不带章节数字(如9.3xxx
2.5.4xxx.md),而采用类似 LCAProblem/ LCAProblem.c LCAProblem-pic-1 这样
的名字”

这样做,不容易根据文章一眼找到对应的代码,有个章节数字可以很快的定位到。
所以,不建议。

好,拿就先按照现在的方法做吧

如果咱们的章节和内容以后变动不大,以后应该好处理;但如果有较大的调整,会有一些(甚至不少的)麻烦。

“不容易根据文章一眼找到对应的代码” 你可以看看tex如何处理这个问题的

于2014年3月24日 15:02:33,July写到:

@fairywell https://github.com/fairywell
“任何文章、图片、代码、目录的名字中,都不带章节数字(如9.3xxx
2.5.4xxx.md),而采用类似 LCAProblem/ LCAProblem.c LCAProblem-pic-1 这样
的名字”

这样做,不容易根据文章一眼找到对应的代码,有个章节数字可以很快的定位到。
所以,不赞成。


Reply to this email directly or view it on GitHub
#234 (comment).

commented

@fairywell
“但如果有较大的调整,会有一些(甚至不少的)麻烦”,哪些麻烦?
你可以看看tex如何处理这个问题的,tex 是如何处理的?

比如,如果要删掉第九章第7张图片,那么9.7以后的数字全部要重排,其他有引用该章节的数字也要全部重排

相信july已经考虑过这些,把章节统筹稳定,现在这样做道也是省力的一个方法。

于2014年3月25日 14:55:52,July写到:

@fairywell https://github.com/fairywell
“但如果有较大的调整,会有一些(甚至不少的)麻烦”,哪些麻烦?
你可以看看tex如何处理这个问题的,tex 是如何处理的?


Reply to this email directly or view it on GitHub
#234 (comment).

@julycoding 我来给python重命名吧。另外,如果想contribute其他语言的代码,是不是直接pull request就可以了?

commented

@sfdye
恩,是的。

是不是可以考虑将命名规范改成如下格式?
如:02.01:寻找最小的 k 个数.c
这样就不会出现
10.1.3 在 1.3 和 2.1之间显示
6.11 在 6.4 之前显示
这样的问题了
强迫症表示这样看着非常不舒服

大部分问题已经解决。

commented

这个还要进一步调整,所以先reopen 了。