Я только что разработал проект в Github, внес свои изменения и т. Д. Это заставило меня задуматься: в основном я вижу README.txt в проектах с открытым исходным кодом, а файл, который я редактировал, был Readme.txt. Это своего рода стандартизация или я должен был оставить все как есть?
naming-standards
Толга Озсес
источник
источник
Ответы:
Заглавные буквы выделяются и делают файл легко видимым, что имеет смысл, потому что это, вероятно, первое, на что новый пользователь захочет взглянуть. (Или, по крайней мере, следовало бы посмотреть…) Как уже говорили другие, имена файлов, начинающиеся с заглавной буквы, будут перечислены перед именами в нижнем регистре в ASCIIbetical sorting (
LC_COLLATE=C
), что помогает сделать файл видимым на первый взгляд.Этот
README
файл является частью набора файлов, который обычно ожидает найти пользователь пакета бесплатного программного обеспечения. Другими являютсяINSTALL
(инструкции по сборке и установке программного обеспечения),AUTHORS
(список участников),COPYING
(текст лицензии),HACKING
(как начать вносить свой вклад, может быть, включая список начальных точек TODO),NEWS
(последние изменения) илиChangeLog
(в основном избыточные с системы контроля версий).Это то, что Стандарты Кодирования GNU должны сказать о
README
файле.Поскольку всегда полезно стремиться к наименьшему удивлению ваших пользователей, вы должны следовать этому соглашению, если нет веских причин для отклонения. В мире UNIX расширения имен файлов традиционно использовались редко, поэтому каноническое имя файла
README
без суффикса. Но большинство пользователей, вероятно, без проблем поймут, что имя файлаREADME.txt
имеет то же значение. Если файл написан на Markdown , имя файла вродеREADME.md
также может быть разумным. Избегайте использования более сложных языков разметки, таких как HTML, вREADME
файл, однако, потому что это должно быть удобно читать на текстовом терминале. Вы можете указать пользователям руководство по программному обеспечению или его онлайн-документацию, которая может быть написана в более сложном формате, для получения подробной информации изREADME
файла.источник
Традиционно файл назывался README в верхнем регистре, потому что среды командной строки, которые используют алфавитный порядок, поместили бы файл в верхнюю часть. Это делает их легко видимыми в больших каталогах.
Скорее всего, это пережиток мира Unix / Linux, где вы будете загружать исходники, а затем создавать свое программное обеспечение. Наличие таких файлов, как README и INSTALL в верхней части представления «список содержимого каталога», упрощает просмотр того, что они есть, вместо просмотра всего содержимого из интерфейса командной строки. Тот же самый базовый принцип работает и для github (и на самом деле работает и в интерфейсах GUI, если подумать об этом, так что он все еще может быть достоинством)
Ни в коем случае не жесткое правило, но очень вероятно, что каждый делает это как привычку, потому что другие проекты делают это. Если нет явной причины НЕ делать этого, вам, вероятно, следует использовать все заглавные буквы только потому, что вы увидите, что они используются таким образом во многих других проектах. Это также имя по умолчанию, используемое Github при создании нового хранилища.
источник
ls -l | less
.README обычно пишется в верхнем регистре. Таким образом, команда
ls
Unix поместила файл в начале списка каталогов (заглавные буквы идут перед строчными в порядке ASCII).источник
ls
как правило, не так на современных системах.LC_COLLATE="en_US.ascii" ; ls -l
противLC_COLLATE="en_US.UTF-8" ; ls -l
)