Size: a a a

technicalwriters

2020 September 25

ДС

Дмитрий Сунцов... in technicalwriters
Переслано от Дмитрий Сунцов...
ну к примеру есть тысяча HTML файлов с топиками.

я говорю - вот группа Клиент1
внутри группы есть юзер1 и юзер2

я настраиваю, что юзер1 видит 100 топиков таких то
юзер2 видит всю тысячу
юзер3 видит ещё другие 300

есть группа Клиент2
внутри свои юзеры со своими правами


но при всем при этом файлы HTML для всех одинаковые!


и в зависимости от того, какой юзер зашёл на портал - он видит свой набор топиков
источник

ДС

Дмитрий Сунцов... in technicalwriters
меняем "юзер" на "роль" или добавляем ещё новую сущность роли  в ту же схему. и получаем то что нужно
источник

E

Evgeniia in technicalwriters
Maria Shabanova
Так интересно свои документы многогодичной давности читать. Вот что меня сподвигло вместо "добавить новый объект" написать "ввести новый объект в эксплуатацию"? 🤔
постоянно сгораю от стыда, читая свои старые тексты )
источник

SR

Stas Rychkov in technicalwriters
Дмитрий Сунцов
Переслано от Дмитрий Сунцов
ну к примеру есть тысяча HTML файлов с топиками.

я говорю - вот группа Клиент1
внутри группы есть юзер1 и юзер2

я настраиваю, что юзер1 видит 100 топиков таких то
юзер2 видит всю тысячу
юзер3 видит ещё другие 300

есть группа Клиент2
внутри свои юзеры со своими правами


но при всем при этом файлы HTML для всех одинаковые!


и в зависимости от того, какой юзер зашёл на портал - он видит свой набор топиков
источник

SR

Stas Rychkov in technicalwriters
Или так? https://github.com/topics/role-based-access-control

Смотрели что-то такое?
источник

FM

Fox Mulder in technicalwriters
Я бы дал совет - уходить от dita в сторону легковесных языков.
На текущем проекте я сделал сайт на основе asiidoc + antora. Сайт предусматривает, на данный момент) такие разграничения, как:
- вывод контента по релизам
- вывод контента по типам документации
- вывод контента под разных заказчиков
- поиск по контенту
- планируется автоматический конверт pdf(docx)

В результате, чтобы разные клиенты видели только свой тип документации, необходимо весь набор html (именно в них конвертит antora) отдать фронту, чтобы он прикрутил там разграничение доступа.

В итоге, команда пишет в аскидоке и сливают в свои репы,  делаем ревью и делаее мердж-реквест в мастер и по релизным веткам. Я билдю ./public через антору, при этом, настроенный пайплайн стягивает контент сам и сам же, через подложенный мною структура сайта (всякие js+css) билдит сайт.
Далее сайт помещается на апач (пока ручками). Ну и авторизация не прикручена, ибо пока в прод не пущен проект
источник

FM

Fox Mulder in technicalwriters
В oxygenxml работал и всё-таки dita тяжеловата, да и устарела она.
источник

СФ

Семён Факторович... in technicalwriters
источник

ДЧ

Дарья Чернавина... in technicalwriters
Недавно узнала, что есть расширение Google Docs, которое фигачит док в markdown, который перефигачивается в HTML. Хожу и радуюсь, век живи — век учись.
источник

CV

Cro Vin in technicalwriters
Дарья Чернавина
Недавно узнала, что есть расширение Google Docs, которое фигачит док в markdown, который перефигачивается в HTML. Хожу и радуюсь, век живи — век учись.
Дарья, вы о stackedit или ином?
источник

S

Sara in technicalwriters
Дарья Чернавина
Недавно узнала, что есть расширение Google Docs, которое фигачит док в markdown, который перефигачивается в HTML. Хожу и радуюсь, век живи — век учись.
Расскажите ищо, пожалуйста)
источник

ДС

Дмитрий Сунцов... in technicalwriters
Fox Mulder
Я бы дал совет - уходить от dita в сторону легковесных языков.
На текущем проекте я сделал сайт на основе asiidoc + antora. Сайт предусматривает, на данный момент) такие разграничения, как:
- вывод контента по релизам
- вывод контента по типам документации
- вывод контента под разных заказчиков
- поиск по контенту
- планируется автоматический конверт pdf(docx)

В результате, чтобы разные клиенты видели только свой тип документации, необходимо весь набор html (именно в них конвертит antora) отдать фронту, чтобы он прикрутил там разграничение доступа.

В итоге, команда пишет в аскидоке и сливают в свои репы,  делаем ревью и делаее мердж-реквест в мастер и по релизным веткам. Я билдю ./public через антору, при этом, настроенный пайплайн стягивает контент сам и сам же, через подложенный мною структура сайта (всякие js+css) билдит сайт.
Далее сайт помещается на апач (пока ручками). Ну и авторизация не прикручена, ибо пока в прод не пущен проект
у нас довольно похоже.
доки в DITA.
оттуда экспорт в PDF (для клиентов пока так) и в webhelp для внутреннего использования.
дальше это пушится в GIT и там автоматом деплоится на внутренний сайт.
источник

ДС

Дмитрий Сунцов... in technicalwriters
кастомизация под каждого клиента - не проблема. но множить все это по количеству клиентов и потом поддерживать - тяжко. хочется если отдавать наружу, то сразу по хорошему
источник

FM

Fox Mulder in technicalwriters
Дмитрий Сунцов
кастомизация под каждого клиента - не проблема. но множить все это по количеству клиентов и потом поддерживать - тяжко. хочется если отдавать наружу, то сразу по хорошему
1 ветка в гите - 1 клиент )
источник

ДС

Дмитрий Сунцов... in technicalwriters
Fox Mulder
1 ветка в гите - 1 клиент )
вопрос не в содержимом доки, а в доступе к её разделам. я наверное плохо знаю гит - как он может помочь с этим?

нужен раздельный доступ к разным файлам в зависимости от роли пользователя.

условный админ видит всё
условный бухгалтер видит только свое
условный клерк видит свое

при этом клерку могут изменить права. тогда сразу он должен начать видеть новые документы
источник

ДС

Дмитрий Сунцов... in technicalwriters
а не ждать, пока мы вручную в их экземпляре доки поправим права и пересоберем вебхелп допустим
источник

FM

Fox Mulder in technicalwriters
А зачем в гите доступы то? Просто документация сторитсся в гите и из гита тянутся ветки, чтобы билдить сайт. А вот сайт уже сам имеет методы авторизации
источник

FM

Fox Mulder in technicalwriters
клерки не должны иметь доступ к правкам сорсов
источник

ДС

Дмитрий Сунцов... in technicalwriters
Fox Mulder
клерки не должны иметь доступ к правкам сорсов
дело не в правках. дело в просмотре
источник

ДС

Дмитрий Сунцов... in technicalwriters
бухгалтеру не нужны настройки сети
источник