Size: a a a

Технические писатели

2021 August 31

A

Angela in Технические писатели
в анторе дизайн тянется из отдельной репы независимо от контента, и там можно легче сделать всё, что хочется

в сфинксе помню, были танцы с бубном для прикручивания пары строчек в дизайн
источник

FM

Fox Mulder in Технические писатели
когда я посмотрел возможности синтаксиса adoc, то впечатлился. Очень богатый возможности по написанию доки. А что более важно - интуитивнее в части синтаксиса. Antora же настолько мощный инструмент по генерации сайта, что просто диву даешься. конечно, если не брать фичу по генерации api. Тут я бы попробовал react-doc например
источник

A

Angela in Технические писатели
деплой проще, чем в сфинксе
это моё субъективное мнение 😅

собрал все репы в одном конфиге, написал навигационные файлы для каждой сборки, и все собирается прекрасно
источник

ET

Eduard Tibet in Технические писатели
Т.к. adoc = текстовый DocBook :) Не зря второй пилили столько лет :) Стандарт отточен.
источник

FM

Fox Mulder in Технические писатели
Сорри, пишу с телефона, бывают очепятки
источник

A

Angela in Технические писатели
да, и адок больше понравился по синтаксису, чем рст
источник

FM

Fox Mulder in Технические писатели
если не adoc, то я бы выбрал mdx. Вот как то у меня rst не зашёл. но это только моё личное мнение
источник

ET

Eduard Tibet in Технические писатели
Кстати, на adoc работает neo4j: https://neo4j.com/docs/operations-manual/4.1/cloud-deployments/
источник

BF

Bobba Fett in Технические писатели
Вот всегда эти холивары доходят до того, что ближе к XML. Какой смысл оценивать легковесную разметку, суть которой в том, чтобы упростить синтаксис, зафиксировав семантику, если нужна полноценно допиливаемая семантика? Это что-то из разряда оценивать спорткар по тому, насколько он ближе других к семейному минивэну.
источник

D

Dmitriy in Технические писатели
Проверил на pandoc, та же фигня. Похоже на неправильную реализацию, ибо в reference: Unless the options literal, code, or parser are given, the file is parsed in the current document's context at the point of the directive.
источник

А

Александр Мокрушин... in Технические писатели
Завести issue на гитхабе?)
источник

D

Dmitriy in Технические писатели
Надо наверное. Но лучше сразу PR
источник

A

Angela in Технические писатели
неплохо выглядит, я смотрю, у них через WordPress сделано

насколько оправдано использование CMS? кто делал сборку доки через любую CMS?
источник
2021 September 01

ET

Eduard Tibet in Технические писатели
Не совсем... Оценки идут по поводу приближенности _семантического словаря_ одного и другого, а не способа маркировки этой семантической структуры.
источник

ET

Eduard Tibet in Технические писатели
Где вы там видите Wordpress или другую CMS? Это чистый SSG, и, как следствие - чистая статика (ну, конечно, не без включения JS где нужна интерактивность или красивость :)
источник

ET

Eduard Tibet in Технические писатели
Вот на чем там все работает: https://github.com/neo4j/neo4j-documentation
источник

A

Angela in Технические писатели
на разводной страничке по доке у них WordPress
https://neo4j.com/docs/
источник

SK

Sergey Karlov in Технические писатели
Коллеги, добрый день. Я никак не привыкну к косякам  microsoft word и неудобством работы. Не хотелось бы обсуждать конкретные баги и кейсы, хотелось бы узнать есть ли  случаи успешного  перехода на другое ПО (libre office, open office и т.п. продукты, поддерживающие форматы .docx, .doc)?
источник

AY

Andrei Yemelianov in Технические писатели
Есть
источник

AY

Andrei Yemelianov in Технические писатели
Опишите ситуацию, Сергей: что не устраивает и что хотелось бы получить. Возможно, я смогу подсказать подробнее.
источник