Wiki или список сниппетов

[leotop]

Хотелось бы видеть сразу весь список имеющихся сниппетов на вики странице или отдельным файлом.

В списке по возможности сделать TODO, что желательно добавить.

Файлов стало много, сложно ориентироваться, что есть, чего еще нет.

[lord-alfred]

Уже обсуждали в чате, что в идеале нужно генерировать документацию (список сниппетов + их описания) из самих сниппетов (парсингом начальных строк с комментариями). Похожим образом генерируется документация по встроенным методам ZennoPoster (см.: https://help.zennolab.com/en/v5/zennoposter/5.30.0.0/webframe.html ).

Затем можно было бы полученные html разместить в ветке для github pages, а потом попросить у разработчиков ZP сделать поддомен аля snippets_zennolab_com и прикрутить его по CNAME.

Пока что на этой стадии было решено собрать как можно больше сниппетов в принципе, чтоб посмотреть кто как их оформляет и решить как раз каким образом стоит их потом парсить. Думаю, стоит ещё подождать какое-то время, чтоб оставшиеся желающие добавили свои сниппеты через PR, а уже в дальнейшем думать о генерации документации (потому что есть подозрения, что без активного участия сообщества - данный репозиторий может заглохнуть и в итоге никто не будет добавлять новый код, а значит и решать задачу генерации документации пока что преждевременно).

[leotop]

Речь не о документации, а обычном списке, просто листинг файлов.

[lord-alfred]

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

Если есть другие идеи, то было бы здорово услышать, Вдруг я слишком хардкорно хочу решать задачу :)

[lord-alfred]

Лайфхак: если зайти на главную страницу репозитория и нажать кнопку "t", то откроется поиск по именам файлов. Очень удобно ;-)

Или можно попасть туда, перейдя по следующей ссылке: https://github.com/ZennoHelpers/Snippets/find/master

[Zymlex]

Или можно попасть туда, перейдя по следующей ссылке: https://github.com/ZennoHelpers/Snippets/find/master

Не весь список отображается.

Если есть другие идеи, то было бы здорово услышать, Вдруг я слишком хардкорно хочу решать задачу :)

Из простого, на ум только приходит, создание полного списка файлов батником, на подобии ссылки выше.

[lord-alfred]

Не весь список отображается.

Там можно ещё начать вводить название сниппета и он покажет то, что есть с таким именем

Из простого, на ум только приходит, создание полного списка файлов батником, на подобии ссылки выше.

Ну, а там и не долго допилить чтоб первые строки с комментарием ещё заодно парсились, а потом это всё в красивый html вставлялось :)
Не, конечно, можно начать и с просто генерации батником листинга файлов и его так и закидывать в ветку github pages, но вроде как интереснее написать небольшой аля парсер на C# ))

[leotop]

Через API функции нет, для githab pages, отображения файлов?

[lord-alfred]

К сожалению, я о таком функционале не знаю :(
Если есть, то может и вправду было бы проще его прикрутить как-то