Board.KolibriOS.org
http://board.kolibrios.org/

Документация и справочная система
http://board.kolibrios.org/viewtopic.php?f=6&t=1183
Страница 4 из 4

Автор:  IgorA [ Пт янв 25, 2019 5:48 pm ]
Заголовок сообщения:  Re: Документация и справочная система

Alex2003 писал(а):
SF KOS ещё не переведён полностью: уж очень много текста...

Я думал что имелся ввиду перевод с русского на английский
Alex2003 писал(а):
Я его загоняю в веб страницу

А почему через Word? Он же кучу лишнего форматирования в файл сохраняет.
Например файл 143,2 кб (в htm) тогда как размер текста в нем 18,5 кб (при сохранении в txt). Т.е. 87% файла это Word-овский мусор!

Автор:  Alex2003 [ Пт янв 25, 2019 7:45 pm ]
Заголовок сообщения:  Re: Документация и справочная система

А в чём тогда предлагаешь делать доки?

Автор:  IgorA [ Пт янв 25, 2019 11:33 pm ]
Заголовок сообщения:  Re: Документация и справочная система

Наверное самый лучший вариант это править вручную, но он же и самый долгий. Вот пример этого файла, где я в Notepad-е по быстрому сделал автозамены для заголовков:
Вложение:
sysfuncr.7z [32.84 КБ]
5 скачиваний

Размер получившегося файла 186 Кб, в то время как исходный 220 Кб. Уменьшение получилось за счет того, что были убраны символы форматирования такие как ===== и ----- , которых было очень много. По идее весь файл с тегами должен быть примерно такого же размера как и исходный файл.
В крайнем случае использовать программу ВебЛомастер для уменьшения размера файла, но она может вместе с удалением лишних тегов изменить и форматирование файла.

Автор:  dunkaist [ Сб янв 26, 2019 1:17 am ]
Заголовок сообщения:  Re: Документация и справочная система

You want the same info as in *.txt files but with a nicer markup, right? Doing it manually is time consuming, error prone and will require more synchronization work in the future. My opinion is that there could be two similar approaches:
  1. Convert text docs into, say, AsciiDoc or ReStructuredText and use corresponding tools to generate html/pdf;
  2. Keep text docs in current format and write a small script to parse and convert them into html/tex.

Btw, the latter one is a good programming exercise for beginners.

Автор:  Alex2003 [ Сб янв 26, 2019 9:06 am ]
Заголовок сообщения:  Re: Документация и справочная система

dunkaist, thanks for the good advice!
IgorA, тебе тоже спасибо!

Страница 4 из 4 Часовой пояс: UTC+03:00
Powered by phpBB® Forum Software © phpBB Limited
https://www.phpbb.com/