Фон
У меня было несколько друзей , которые превратили меня на markdown и pandoc для написания документации. На моей нынешней работе мы используем Microsoft Word для написания неструктурированных одноразовых документов для наших конечных пользователей. Я хотел бы начать писать их в уценке по следующим причинам.
- отделение контента от структуры.
- возможность использовать системы контроля изменений для отслеживания обновлений
- Создайте стандартный шаблон, который включает логотип, стандартный текст компании, макет, общий для всей последующей документации.
Я хотел бы создать несколько шаблонов, которые позволят всем документам содержать одинаковый поток информации для наших пользователей. Цель состоит в том, чтобы добавить профессорский взгляд в нашу пользовательскую документацию ИТ-отдела.
Я полагаю, что вики, размещенной в компании, может быть достаточной, но лица, принимающие решения, не позволят этого в данный момент.
Вопрос
Мне нужна помощь в добавлении элементов, таких как логотип, и стандартного текста, который можно добавить в шаблон HTML или PDF. Кроме того, я хотел бы определить макросы, такие как инкапсуляция слова в ! Взрывы будут выделять это слово в соответствии с набором правил, таких как клавиши на клавиатуре или кнопки программного интерфейса. Напротив, инкапсуляция слова в & ampersands изменила бы стиль, чтобы обозначить имя элемента меню GUI.