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/