додзе js библиотека + jsdoc->, как зарегистрировать код?
Некоторые идеи:
-
Простой: не называйте его "Случайным Дерьмом". Измените имя объекта каждый раз так, чтобы ботам пришлось тяжелее, определив его. Они могут все еще искать объекты за 1,00$, в этом случае я иногда предлагаю продать палки за 1$ резины в течение нескольких минут. Поставка за 5$ должна не остаться в долгу.
-
Тяжелее: не заставляйте пользователей сделать, что-либо дополнительное - заставляет компьютеры пользователей сделать что-то дополнительное. Запишите функцию JavaScript, которая работает, интенсивное вычисление, берущее хорошее количество вычислительной мощности - говорят, десятимиллионное простое число - и имеют компьютер пользователя, вычисляют то значение и пасуют назад его перед принятием порядка (возможно, даже для создания "URL" порядка места). Измените функцию для каждого BoC так, чтобы боты не могли предварительно вычислить и результаты кэша (но так, чтобы Вы могли). Вычисление наверху могло бы просто замедлить ботов достаточно для хранения их от спин - если ничто иное, оно замедлит хиты на серверах так, чтобы они могли дышать. Вы могли также варьироваться глубина вычисления - десятимиллионного начала по сравнению со стамиллионным - наугад так, чтобы процесс упорядочивания строго больше не сначала прибывался, сначала подан, и постараться не штрафовать клиентов с более медленными компьютерами.
- E
2 ответа
Все это делается с помощью специального синтаксического анализатора PHP и Drupal . Если вы заглянете в util / docscripts / README и util / jsdoc / INSTALL , вы сможете получить все подробности о том, как создавать документы.
Это отличается от jsdoc-toolkit или JSDoc (как вы обнаружили).
FWIW, я использую jsdoc-toolkit , так как сгенерировать статический HTML намного проще и есть много документации о тегах на кодовой странице Google.
Кроме того, для ясности, я не занимаюсь разработкой самого додзё. Просто я часто использую его на работе.
Процесс dojo jsdoc состоит из двух частей. Существует синтаксический анализатор, написанный на PHP, который генерирует xml и / или json всех перечисленных пространств имен (определенных в util / docscripts / modules, так что вы можете добавлять свои собственные пространства имен. Вверху файла "generate" есть базовые инструкции по использованию. php ") и часть Drupal под названием" jsdoc ", которая устанавливается как модуль / плагин / что угодно Drupal.
Аспект Drupal - это просто базовое представление Dojo этих данных. Хорошо продуманный XSLT или что-то для перебора json и создания html будет работать точно так же, хотя ни один из них не предоставляется по умолчанию (хотелось бы внести свой вклад!). Я сам уклоняюсь от части Drupal, хотя она уже некоторое время работает на api.dojotoolkit.org.
Анализатор документов доступен, так что вы также можете использовать его возможности проверки для написания собственного вывода. Я использую его для генерации автозавершения кода Komodo .cix в [довольно небрежном] файле PHP util / docscripts / makeCix.php, который выгружает найденную информацию в XML-документ, созданный в соответствии со спецификацией. Его можно изменить, чтобы сгенерировать любой вид вывода, который вы выберете, с небольшими изысканиями.
Синтаксис документа полностью определен на странице руководства по стилю: http://dojotoolkit.org/reference-guide/developer/styleguide.html