korney4eg / gg_stuff

MIT License
2 stars 1 forks source link

[Предложение] генерить страницу из документации #8

Closed korney4eg closed 2 years ago

korney4eg commented 2 years ago

Есть мысль, чтобы генерить документацию в html и отображать отдельно. С нашей стороны, особо изменений не нужно, менять нужно будет markdown файл, только пользователям его можно будет отдавать как страничку в интернете(с нужным оформлением в стиле GG. Например, используя GitHub Pages.

@agentgoblin что думаешь?

agentgoblin commented 2 years ago

В принципе нормально. Только какие преимущества перед показом markdown'а через GitHub? Просто чтобы было красивое или чтобы онлайн-форматтер стилей запилить и туда справку повесить?

И через что перегонять markdown в HTML будем? Через рекомендованный GitHub Pages Jekyll? Я его побаиваюсь, если честно, он на руби написан, а у меня с ним как-то не сложилось.

korney4eg commented 2 years ago

Да, jekyl.

Я им раньше генерировал бложег, потом перешёл на gohugo. Даже сейчас один сайтик хощу https://github.com/korney4eg/korney4eg.github.io без проблем.

Да, главное преимузество в том, что можно оформить в стиле ГГ. Опять же GitHub Pages - это такой бесплатный хостинг для статичных сайтов.

korney4eg commented 2 years ago

получил обратную связь на дискорде ГГ. Ещё раз спасибо!

image

Кстати, ты есть на дискорде ГГ?

agentgoblin commented 2 years ago

Кстати, ты есть на дискорде ГГ?

Могу добавиться вечером.

korney4eg commented 2 years ago

закрываю, так как вроде не нужно