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

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

Author:  IgorA [ Fri Jan 25, 2019 5:48 pm ]
Post subject:  Re: Документация и справочная система

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

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

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

Author:  Alex2003 [ Fri Jan 25, 2019 7:45 pm ]
Post subject:  Re: Документация и справочная система

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

Author:  IgorA [ Fri Jan 25, 2019 11:33 pm ]
Post subject:  Re: Документация и справочная система

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

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

Author:  dunkaist [ Sat Jan 26, 2019 1:17 am ]
Post subject:  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.

Author:  Alex2003 [ Sat Jan 26, 2019 9:06 am ]
Post subject:  Re: Документация и справочная система

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

Author:  Leency [ Sat Apr 27, 2019 3:13 pm ]
Post subject:  Re: Документация и справочная система

Alex2003 wrote:
Держите переведённый!
Перевод был сделан в Word из-за чего HTML файлы не открываются черзе WebView в Колибри и имеют большой размер.

Дал Alex2003 инструкции как создавать корректные HTML файлы в plain-текстовом редакторе с подсветкой синтаксиса.

Author:  Alex2003 [ Sat Apr 27, 2019 3:32 pm ]
Post subject:  Re: Документация и справочная система

Уже исправляю!

Page 4 of 4 All times are UTC+03:00
Powered by phpBB® Forum Software © phpBB Limited
https://www.phpbb.com/