REBOL 3/Скрипты REBOL 3: различия между версиями
Содержимое удалено Содержимое добавлено
Строка 244:
Старайтесь выделять связные выражения и сгруппированные.
Аккуратно используйте переносы.
'''Стандартная табуляция REBOL''' - четырех-пробельная.
Существуют различные редакторы, где вы можете изменять предпочтительные настройки.
'''Де-табуляция прежде переноса''' - символ табуляции ASCII 9 не идентичен четырем пробелам во многих обозревателях, поэтому используйте редактор или REBOL функции для де-табуляции перед опубликованием.
'''Предел длины строки в 80 символов''' легче прочитать в портативных редакторах и в той же электронной почте.
Кроме того , длинные строки создают проблемы при загрузке.
'''Имена слов''' - демонстрируют ваш код.
Относитесь к выбору имен очень критично.
Строка 254 ⟶ 258 :
Когда есть возможность используйте слова естественных языков.
В простом прямой путь.
'''Используйте краткие слова, связанные со смыслом'''.
Причем локальные слова могут быть короче простых слов, а длинные лучше использовать для глобальных слов.
Строка 259 ⟶ 264 :
Не стремитесь сокращать слова.
Слово - редкая ценность!
'''Имена сложных слов иностранного происхождения''' используются стандартным стилем, но не символами, а используя тире.
'''Начинайте имена функций с глаголов'''.
Только потом местоимения, наречия и прилагательные.
Строка 266 ⟶ 273 :
Это слова для объектов и переменных, содержащих данные.
Они могут включать модификаторы (прилагательные) при необходимости.
'''Используйте стандартные имена!'''
'''Заголовки скриптов''' используйте самым активным образом. Они позволяют другим скриптам использовать информацию, например, при каталогизации.
'''Заголовки функций''', как правило обеспечиваюся специальными блоками для строк в пределах 70 символов и меньше.
В них описываются типы значений функции и значения нормального возврата.
'''Имена файлов'''.
Лучший способ - подумать о том, как вы найдете файл через несколько месяцев.
Строка 275 ⟶ 285 :
Не забывайте, что имена файлов участвуют в директориях.
Связывайте их с общими словами.
'''Примеры внедрений'''.
Показывайте в скрипте примеры, как его быстро верифицировать и корректно использовать в других системах.
'''Отладка внедрений'''.
Часто используется для построения отладочных функций как порт скрипта.
Особенно в сети и для файлов, содержащих скрипты, которые посылают и записывают файлы для тестов.
Такие тесты могут быть возможны с контрольными переменными в голове скрипта.
'''Минимизация глобалов'''.
В больших скриптах и, вообще, где только возможно избегайте использовать глобальные имена, которые доставляют внешние выражения другим моделям и функциям.
| |||