Как я добавляю существующие комментарии к RDoc в Ruby? [закрытый]

Как отметил @FelixKling, наиболее вероятным сценарием является то, что узлы, которые вы ищете, еще не существуют.

Однако современные методы разработки часто могут манипулировать элементами документа за пределами дерева документов либо с DocumentFragments, либо просто отсоединением / повторным подключением текущих элементов напрямую. Такие методы могут использоваться как часть шаблонов JavaScript или для предотвращения чрезмерных операций перерисовки / переплавки, в то время как элементы, о которых идет речь, сильно изменяются.

Аналогично, новая функциональность «Теневой DOM» развертывается в современных браузерах позволяет элементам быть частью документа, но не обрабатываться запросом document.getElementById и всеми его методами sibling (querySelector и т. д.). Это делается для инкапсуляции функциональных возможностей и, в частности, скрыть его.

Опять же, скорее всего, элемент, который вы ищете, просто (пока) в документе, и вы должны сделать, как предлагает Феликс , Тем не менее, вы также должны знать, что это все чаще является не единственной причиной того, что элемент может быть необоснованным (временно или постоянно).

42
задан mbigras 30 December 2016 в 06:56
поделиться

2 ответа

Несколько вещей, которые укусили меня:

  • :main: - RDoc использует только последний оцененный; лучше всего для проверки существует только один в проекте, и Вы также не используете --main параметр командной строки.
  • то же как предыдущее, но для :title:
  • :section: не работает очень хорошо
14
ответ дан James A. Rosen 27 November 2019 в 00:02
поделиться

RDoc использует SimpleMarkup, таким образом, довольно просто создать списки, и т.д. с помощью *, - или число. Это также рассматривает строки, которые располагаются с отступом в том же номере столбца как часть того же абзаца, пока нет пустая строка, которая показывает новый абзац. У Вас есть несколько примеров комментариев, Вы хотите RDoc'ed, таким образом, мы могли показать Вам, как сделать их, и затем Вы могли экстраполировать это для остальной части Ваших комментариев?

8
ответ дан Rob Burke 27 November 2019 в 00:02
поделиться
Другие вопросы по тегам:

Похожие вопросы: