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

[julycoding]

首先，无论是优化后的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 。

[Frederick-S]

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

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

[fairywell]

自己建立一個你的問題的子目錄不行嗎？比如 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).

[Frederick-S]

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

[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).

[julycoding]

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

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

[Frederick-S]

@julycoding 我了解了，谢谢。

[julycoding]

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

[chenrenyi]

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

[julycoding]

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

[fairywell]

既然谈到了重命名，我重申下以前的一个观点：
任何文章、图片、代码、目录的名字中，都不带章节数字（如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).

[julycoding]

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

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

[fairywell]

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

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

“不容易根据文章一眼找到对应的代码” 你可以看看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).

[julycoding]

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

[fairywell]

比如，如果要删掉第九章第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).

[sfdye]

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

[julycoding]

@sfdye 赞
恩，是的。

[huskyii]

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

[Boshen]

大部分问题已经解决。

[julycoding]

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