Technical Writing을 위한 저작도구는 무엇이 있을까요..?

ssery의 이미지

선배님들 안녕하세요.

저는 이제 신입 9개월인 직장인입니다.

개발업무를 하면서 기술문서(Datasheet, Manual, Application Note, etc.)를 개편하는 프로젝트를 진행하게 되었습니다.
주로 text기반의 문단 내용 작성, Block diagram, Table 등의 Figure를 많이 활용하는데요.
여러가지 저작 도구 툴을 찾았지만 아직 맘에 드는 저작 툴을 찾지 못해 많은 분들의 의견을 듣고 싶습니다.

회사 규모가 크지 않아 자체적인 솔루션을 가지고 있지는 않고
MS-WORD로 파일을 Technical Document를 작성하고 관리하는데,
MS-Word는 뭔가 공을 들여 작성해도 맘에 드는 아웃풋이 나오지 않고
뭔가 맘에 안드는 버그 아닌 버그들이 절 너무 괴롭혀서 미치겠습니다.ㅠㅠ

같은 내용이라도 LaTeX를 쓴다면 더 깔끔한 레이아웃의 아웃풋이 나오긴 하지만,
몇 백 페이지가 되는 기술문서의 템플릿을 구축하고 직원들을 교육시켜야 하는 일까지 직접 담당해야 합니다.
그러기에는 저는 LaTeX를 본격적으로 배운 적이 없어서 감당할 레벨은 아닌 것 같구요 ㅠㅠ

이전에 그래픽디자인 업으로 Adobe 제품군도 다수 다룰 줄 알지만
Indesign, Illustrator, Photoshop으로 전시회에 필요한 Document들을 만들었는데,
처음 다루시는 개발자 분들이 직접 작성하여 Publish하기에는 어려울 것 같다는 생각이 드네요.

홈페이지 제작 경험도 있어서 html 기반의 저작도구 툴에 관심은 가지만 아직 이렇다할 솔루션은 못찾았습니다..
검색을 해봐도 Frame maker, Publisher, 그 외 자체 솔루션..정도..

어떤 툴이든 도입초기가 어려울 뿐 한번 구축해두면 잘 활용할 것 같긴 하지만...
다른 사람들도 빨리 배울 수 있으면서, 버전관리가 쉽고 효율적인 저작 도구가 없을까요..?

어느정도 규모가 있는 기업에서는 Technical Writing으로 어떤 툴을 사용하는지도 궁금합니다.

많은 분들의 의견 부탁드립니다.

oosap의 이미지

LLVM / Clang 의 문서화 작업에 채택되기도 했구요,

Output formats: HTML (including Windows HTML Help), LaTeX (for printable PDF versions),
Texinfo, manual pages, plain text

이와 같이 다양한 출력 포멧으로 문서화가 가능합니다.
Github 에서는 Github Page 를 Sphinx 로 만들어 공개하는 프로젝트가 많습니다.

https://github.com/nikhilm/uvbook

http://nikhilm.github.com/uvbook

참고링크들은 아래와 같습니다.

http://sphinx-doc.org/index.html

http://matplotlib.org/sampledoc/

http://jong10.com/post/30221511694

http://matplotlib.org/sampledoc/cheatsheet.html?highlight=cheat

Thanks for being one of those who care for people and mankind.
I'd like to be one of those as well.

Prentice의 이미지

Markdown은 어떠세요? Pandoc+miktex로 PDF도 만들 수 있습니다.

pinebud의 이미지

대중적이라면..
MS Office + MS Visio + git 은 어떨까요?

A rose is a rose is a rose..