Size: a a a

technicalwriters

2020 May 13

SR

Stas Rychkov in technicalwriters
Maria Ermakovich
1. проект в гитлаб/гит/битбакет с доступом заинтересованных лиц
2. pandoc конвертнуть экспортнутый конфлюенс, договориться о нейминге файлов и иерархии папок
Спасибо! Тут у нас важное отступление. Исходники должны быть в закрытом сегменте. Сторонние внешние сервисы использовать не можем.

Так что планировали Confluence > Git Nexus > Jenkins > Pandoc >  Confluence | Sphinx (или Hugo).

Может сразу видна фигня в таком плане?
источник

ME

Maria Ermakovich in technicalwriters
Stas Rychkov
Спасибо! Тут у нас важное отступление. Исходники должны быть в закрытом сегменте. Сторонние внешние сервисы использовать не можем.

Так что планировали Confluence > Git Nexus > Jenkins > Pandoc >  Confluence | Sphinx (или Hugo).

Может сразу видна фигня в таком плане?
а зачем хранить конфлюенс в гите? скачали архив, конвертнули локально, скриптом допилили и храните уже .md
не совсем понятно, зачем вам выгружать и в ssg, и в конфлюенс. как долго вы планируете поддерживать параллельно две базы знаний?
источник

SR

Stas Rychkov in technicalwriters
Maria Ermakovich
а зачем хранить конфлюенс в гите? скачали архив, конвертнули локально, скриптом допилили и храните уже .md
не совсем понятно, зачем вам выгружать и в ssg, и в конфлюенс. как долго вы планируете поддерживать параллельно две базы знаний?
Не-не. Конвертировать однократно собирались.

Наверное так получается:


Confluence > MD > Git Nexus > Jenkins > Pandoc >  Confluence | Sphinx (или Hugo).


>скачали архив, конвертнули
_локально
А как это по-человечески делается?

Думали так: https://community.atlassian.com/t5/Confluence-questions/Export-pages-in-Wiki-markup/qaq-p/369110

Но может это плохой ход?
источник

ME

Maria Ermakovich in technicalwriters
Stas Rychkov
Не-не. Конвертировать однократно собирались.

Наверное так получается:


Confluence > MD > Git Nexus > Jenkins > Pandoc >  Confluence | Sphinx (или Hugo).


>скачали архив, конвертнули
_локально
А как это по-человечески делается?

Думали так: https://community.atlassian.com/t5/Confluence-questions/Export-pages-in-Wiki-markup/qaq-p/369110

Но может это плохой ход?
кхе-кхе, у меня за плечами только один опыт диджитал трансформации, делали так:
1. скачать спейс целиком, в зип-архиве (к себе на комп)
2. распаковать (у себя на компе)
3. натравить Pandoc (у себя на компе)
3.5. положить в гит, чтобы много людей могли редактировать
4. допилить .md скриптом в соответствии со своими хотелками (у нас был Docusaurus, добавляли метадату в начале каждого файла)
5. Далее действовать в соответствии с требованиями выбранного ssg. Где-то здесь надо писать Jenkins job, да
источник

SR

Stas Rychkov in technicalwriters
Maria Ermakovich
кхе-кхе, у меня за плечами только один опыт диджитал трансформации, делали так:
1. скачать спейс целиком, в зип-архиве (к себе на комп)
2. распаковать (у себя на компе)
3. натравить Pandoc (у себя на компе)
3.5. положить в гит, чтобы много людей могли редактировать
4. допилить .md скриптом в соответствии со своими хотелками (у нас был Docusaurus, добавляли метадату в начале каждого файла)
5. Далее действовать в соответствии с требованиями выбранного ssg. Где-то здесь надо писать Jenkins job, да
Крутяк. А докузавр, он же облачный? Или там можно клиента поставить у себя и никак ни от кого не зависеть?
источник

НН

Нац Нац in technicalwriters
докузаурус ссг обычный
источник

ME

Maria Ermakovich in technicalwriters
Stas Rychkov
Крутяк. А докузавр, он же облачный? Или там можно клиента поставить у себя и никак ни от кого не зависеть?
не облачный О__о
источник

ME

Maria Ermakovich in technicalwriters
вписать нужные команды в дженкинс джоб
источник

SR

Stas Rychkov in technicalwriters
Maria Ermakovich
вписать нужные команды в дженкинс джоб
Это в доке пандока есть? Или где-то это разжёвано?
источник

ME

Maria Ermakovich in technicalwriters
Stas Rychkov
Это в доке пандока есть? Или где-то это разжёвано?
пандок - для конвертации. не знаю почему вы его так поздно ставите в своем плане )
источник

ME

Maria Ermakovich in technicalwriters
в доках докузавра все разжевано, да
источник

ME

Maria Ermakovich in technicalwriters
сфинкс-хуго-докузавр выбирайте исходя из компетенций фронтэндеров которые будут вам помогать :D
источник

EN

Ekaterina Noskova in technicalwriters
Maria Ermakovich
сфинкс-хуго-докузавр выбирайте исходя из компетенций фронтэндеров которые будут вам помогать :D
сначала показалось, матерное что-то написано)
источник

ME

Maria Ermakovich in technicalwriters
Ekaterina Noskova
сначала показалось, матерное что-то написано)
не в этом вегетарианском чате )
источник

ME

Maria Ermakovich in technicalwriters
етить-колотить это для https://t.me/docsascode
источник

ME

Maria Ermakovich in technicalwriters
там кстати вероятнее помогут, я не настоящий сварщик
источник

SR

Stas Rychkov in technicalwriters
Нац Нац
докузаурус ссг обычный
Спасибо. А то вдруг там консоли какие облачные Netlify и всё такое.

Кстати, нет на примете какой-то такой CMS, чтобы SSG управлять? Или это нафиг не надо?
источник

НН

Нац Нац in technicalwriters
Stas Rychkov
Спасибо. А то вдруг там консоли какие облачные Netlify и всё такое.

Кстати, нет на примете какой-то такой CMS, чтобы SSG управлять? Или это нафиг не надо?
нетлифай это намазка поверх ссг, по желанию, они друг с другом не связаны никак
источник

НН

Нац Нац in technicalwriters
Stas Rychkov
Спасибо. А то вдруг там консоли какие облачные Netlify и всё такое.

Кстати, нет на примете какой-то такой CMS, чтобы SSG управлять? Или это нафиг не надо?
netlify cms 🙂
источник

НН

Нац Нац in technicalwriters
Но да, это нафиг не надо
источник