Телеграмм чат группы docsascode страница 585

2020 February 04

RG

Ramil G in DocOps-сообщество

Нац Нац

Класть в соседние папочки версии и в хэдере вместо языков тулить версии

Ок. Это вариант. Получается отдельный сайт для каждой версии. Приемлемо, не идеально.

источник

14:55пожаловаться #1

NV

Nick Volynkin in DocOps-сообщество

Fox Mulder

глючный этот hugo:
1. постоянно, при правках, надо удалять public
2. импортирование новых shortcodes еще та задача
3. многие js-файлы написаны без соблюдения стандартов разметки

+1, там инкрементальная сборка, не надо чистить public.

источник

14:56пожаловаться #2

НН

Нац Нац in DocOps-сообщество

Fox Mulder

я поднял сайт за вечер на теме techdoc, потом мне понадобились шорткады из темы book, а потом в раскрывающихся списках я захотел заменить знаки + и - на треугольники.
И вот тут я прифигел, от того, что творится в кишках hugo

Я может не на русском пишу или как-то невнятно, повторяю, hugo - один файл на языке программирования гоу, он скомпилирован статически, никаких кишков ты там не видишь и не можешь видеть, все твои проблемы, если и есть - от кривой темы (или же рук)

источник

14:56пожаловаться #3

FM

Fox Mulder in DocOps-сообщество

Nick Volynkin

+1, там инкрементальная сборка, не надо чистить public.

Running hugo does not remove generated files before building. This means that you should delete your public/ directory (or the publish directory you specified via flag or configuration file) before running the hugo command. If you do not remove these files, you run the risk of the wrong files (e.g., drafts or future posts) being left in the generated site.

источник

14:57пожаловаться #4

FM

Fox Mulder in DocOps-сообщество

https://gohugo.io/getting-started/usage/

gohugo.io

Basic Usage

Hugo's CLI is fully featured but simple to use, even for those who have very limited experience working from the command line.

источник

14:58пожаловаться #5

НН

Нац Нац in DocOps-сообщество

это note, а не железное правило, мол just in case что-то пойдет не так. но ничего не идет не так

источник

14:59пожаловаться #6

NV

Nick Volynkin in DocOps-сообщество

Нац Нац

Я может не на русском пишу или как-то невнятно, повторяю, hugo - один файл на языке программирования гоу, он скомпилирован статически, никаких кишков ты там не видишь и не можешь видеть, все твои проблемы, если и есть - от кривой темы (или же рук)

Давай без перехода на личности

источник

14:59пожаловаться #7

NV

Nick Volynkin in DocOps-сообщество

Fox Mulder

Running hugo does not remove generated files before building. This means that you should delete your public/ directory (or the publish directory you specified via flag or configuration file) before running the hugo command. If you do not remove these files, you run the risk of the wrong files (e.g., drafts or future posts) being left in the generated site.

Если очень хочешь зачищать каждый раз, напиши makefile. Но вообще в процессе работы это не нужно. И обрати внимание на hugo serve, это очень удобно

источник

15:01пожаловаться #8

FM

Fox Mulder in DocOps-сообщество

Nick Volynkin

Если очень хочешь зачищать каждый раз, напиши makefile. Но вообще в процессе работы это не нужно. И обрати внимание на hugo serve, это очень удобно

Это находится в документации на продукт, написанной разработчиками

источник

15:02пожаловаться #9

NV

Nick Volynkin in DocOps-сообщество

Стоп!

источник

15:02пожаловаться #10

NV

Nick Volynkin in DocOps-сообщество

Пожалуйста, остыньте и держите себя в руках.

источник

15:06пожаловаться #11

RG

Ramil G in DocOps-сообщество

Нац Нац

Антора это как пирина для аскидока, а хуго будет как на кариматик прилечь

Имеете практический опыт использования обоих?

источник

15:06пожаловаться #12

VS

Vadim Smelyanskiy in DocOps-сообщество

Fox Mulder

Running hugo does not remove generated files before building. This means that you should delete your public/ directory (or the publish directory you specified via flag or configuration file) before running the hugo command. If you do not remove these files, you run the risk of the wrong files (e.g., drafts or future posts) being left in the generated site.

Под "before building", насколько я понимаю, они имеют в виду "перед сборкой сайта" в том виде, как его потом на хост заливают

Для разработки есть LiveReload

источник

16:49пожаловаться #13

NV

Nick Volynkin in DocOps-сообщество

Vadim Smelyanskiy

Под "before building", насколько я понимаю, они имеют в виду "перед сборкой сайта" в том виде, как его потом на хост заливают

Для разработки есть LiveReload

+1

источник

17:31пожаловаться #14

ИЦ

Игорь Цупко in DocOps-сообщество

Коллеги, у меня репа в гитлабе с докой. С докой работают только в рамках гитлаба, без рендера и публикации на внешние ресурсы.
Есть идеи, как в такой ситуации делать инклюды?

источник

23:07пожаловаться #15

ИЦ

Игорь Цупко in DocOps-сообщество

Хм. Сам нашёл ответ. AsciiDoc решает.

источник

23:31пожаловаться #16

ML

Maksim Lapshin in DocOps-сообщество

а куда он выливает результат?

источник

23:39пожаловаться #17