Документация и справочная система

You can leave links to different KoOS-related sites and articles here
  • А в чём тогда предлагаешь делать доки?
    Я один из тех, кто ещё не программист, но уже не новичок.
    Редактор в группе "KolibriOS - официальная группа".
  • Наверное самый лучший вариант это править вручную, но он же и самый долгий. Вот пример этого файла, где я в Notepad-е по быстрому сделал автозамены для заголовков:
    sysfuncr.7z (32.84 KiB)
    Downloaded 349 times
    Размер получившегося файла 186 Кб, в то время как исходный 220 Кб. Уменьшение получилось за счет того, что были убраны символы форматирования такие как ===== и ----- , которых было очень много. По идее весь файл с тегами должен быть примерно такого же размера как и исходный файл.
    В крайнем случае использовать программу ВебЛомастер для уменьшения размера файла, но она может вместе с удалением лишних тегов изменить и форматирование файла.
  • 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.
  • dunkaist, thanks for the good advice!
    IgorA, тебе тоже спасибо!
    Я один из тех, кто ещё не программист, но уже не новичок.
    Редактор в группе "KolibriOS - официальная группа".
  • Alex2003 wrote:Держите переведённый!
    Перевод был сделан в Word из-за чего HTML файлы не открываются черзе WebView в Колибри и имеют большой размер.

    Дал Alex2003 инструкции как создавать корректные HTML файлы в plain-текстовом редакторе с подсветкой синтаксиса.
    Из хаоса в космос
  • Уже исправляю!
    Я один из тех, кто ещё не программист, но уже не новичок.
    Редактор в группе "KolibriOS - официальная группа".
  • Here is (quite outdated) sysfuncs.txt converted to markdown.

    I don't know how to easily convert this to a file with table of contents, I didn't try. But it should be much easier than with current plain text format.
  • dunkaist wrote:I don't know how to easily convert this to a file with table of contents, I didn't try. But it should be much easier than with current plain text format.
    You can try pandoc.
    Attachments
    sysfuncs.zip (45.81 KiB)
    Downloaded 238 times
  • Файл (root)/kernel/trunk/docs/sysfuncr.txt

    Функция 48, подфункция 5

    * (left,top) - координаты левого верхнего угла,
    (right,bottom) - координаты правого нижнего.
    Таким образом, размер рабочей области по оси x определяется
    формулой right-left+1, по оси y - формулой bottom-right+1.

    Вместо bottom-right должно быть bottom-top
  • Fixed #8994

    @moderators please move this topic into http://board.kolibrios.org/viewtopic.ph ... 83&p=75113
    dunkaist: done
    Из хаоса в космос
  • Who is online

    Users browsing this forum: No registered users and 2 guests