Board.KolibriOS.org

Official KolibriOS board
It is currently Fri Jan 24, 2020 11:00 am

All times are UTC+03:00




Post new topic  Reply to topic  [ 69 posts ]  Go to page Previous 1 2 3 4 5 Next
Author Message
PostPosted: Mon May 03, 2010 10:12 pm 
Offline

Joined: Tue Sep 12, 2006 9:44 pm
Posts: 37
А почему вопрос ?

_________________
Все сложное - просто!


Top
   
PostPosted: Tue May 04, 2010 12:30 am 
Offline
User avatar

Joined: Wed Jan 27, 2010 10:59 am
Posts: 269
G@K wrote:
А почему вопрос ?

Потому что, обычно, и юзер и программист ищут в документации ответы на вопросы: как настроить систему, как ползоватся той или иной программой, какая функция возвращает нужное значение, как работает планировщик задач и т.п.

_________________
ушёл...


Top
   
PostPosted: Tue May 04, 2010 3:42 pm 
Offline
User avatar

Joined: Fri Jun 27, 2008 3:22 pm
Posts: 988
Very good. :) Только вот хотелось бы какое-то выделение кода в тексте, в идеале подсветкой синтаксиса, как в fasmw.


Top
   
PostPosted: Tue May 04, 2010 4:20 pm 
Offline
User avatar

Joined: Wed Jan 27, 2010 10:59 am
Posts: 269
Вот новый выпуск. Так как времени у мну почти нет, изменения совсем небольшие - переделана заглавная страница, теперь документация называется "Pterox' DocPack" (надеюсь Willow не будет против - название приглянулось :)), почти на каждой странице раздела "KolibriOS API" появилась ссылка для открытия содержания этого самого раздела, чтобы не нажимать двести раз кнопку [<-] (назад), также добавлен мануал по ФАСМу.
Quote:
Very good. :) Только вот хотелось бы какое-то выделение кода в тексте, в идеале подсветкой синтаксиса, как в fasmw.

Спасибо :wink: В следующем выпуске постараюсь сделать подсветку и многое что еще другое.
З.Ы. Этот выпуск сделан больше для того, чтобы показать - дело не заглохло, и хоть малыми шагами, но движется навстречу прогрессу :lol:
http://ftp.kolibrios.org/users/Nasarus/Pterox'_DocPack/KOS_0.7.7.0+/R3.7z

_________________
ушёл...


Top
   
PostPosted: Wed May 05, 2010 12:36 am 
Offline
User avatar

Joined: Mon Feb 09, 2009 4:13 am
Posts: 445
Уже лучше, но в разделе "Установка" почему-то находится описание API функции. А в целом документация мне нравиться. :D

_________________
\ Маузер в руке, Путин – на крюке! \ Путину – клизму! Смерть капитализму! \ Путин – параша, победа будет наша!\
\ Застрели буржуя в спину! Он не лучше чем скотина! \
Image


Top
   
PostPosted: Wed May 05, 2010 12:45 am 
Offline
User avatar

Joined: Wed Jan 27, 2010 10:59 am
Posts: 269
Rock_maniak_forever wrote:
Уже лучше, но в разделе "Установка" почему-то находится описание API функции. А в целом документация мне нравиться. :D

Исправим-с))

_________________
ушёл...


Top
   
PostPosted: Wed May 05, 2010 6:27 am 
Offline
Mentor
User avatar

Joined: Tue Jan 15, 2008 11:27 am
Posts: 752
1) файл hot_keys.htm битый (забит нулями)
2) почему бы "Предыдущие выпуски" не разбить по версиям?
3) если перейти к документу в папке api, не работает ссылка внизу страницы ("История выпусков"). нужно изменить относительный путь.


Top
   
PostPosted: Wed May 05, 2010 6:42 am 
Offline
User avatar

Joined: Wed Jan 27, 2010 10:59 am
Posts: 269
Albom wrote:
1) файл hot_keys.htm битый (забит нулями)
3) если перейти к документу в папке api, не работает ссылка внизу страницы ("История выпусков"). нужно изменить относительный путь.

Сегодня поправлю и выложу
Albom wrote:

http://ftp.kolibrios.org/users/Nasarus/ ... 7.0+/R2.7z - предыдущая версия, старые может как-нибудь потом выложу.

_________________
ушёл...


Top
   
PostPosted: Wed May 05, 2010 8:07 am 
Offline
User avatar

Joined: Wed Jan 27, 2010 10:59 am
Posts: 269
Quote:
2) почему бы "Предыдущие выпуски" не разбить по версиям?

Извиняюсь, неправильно понял (я дурак). Обязательно сделаю это в релизе R5

_________________
ушёл...


Top
   
PostPosted: Wed May 05, 2010 8:10 am 
Offline

Joined: Mon Sep 24, 2007 11:11 am
Posts: 2814
I. Информация для пользователя KolibriOS
"Этот выпуск" - не совсем понятно, о системе или о справке идет речь. Может, "Информация об этой версии системы", или еще как-то?
Лицензия - "Лицензионное соглашение"? Почему бы сразу не открывать GNU GPL, вместо того, чтобы заставлять пользователя потом нажимать два раза на кнопку назад?
TCP/IP стек - в информации для пользователя идет раньше, чем горячие клавиши. Однако содержит в себе информацию, важную скорее для разработчика. Лучше может разделить на две части? Одна - как настроить сеть (примено так и назвать), а другая - как разрабатывать приложения с доступом к стеку.
Другие приложения - не сразу и поймешь, какие-такие другие.
Предыдущие выпуски - скорее я бы включил все это в раздел "для любознательных"

Зато добавил бы страничку, описывающую основные возможности системы, требования к ПК и названия программ - какие для чего нужны.

II. Для программиста
Документация по API. mike.dld на wiki предложил использовать таблицы для наглядного описания системных функций. Почему бы не поступить именно так? Таблицы можно делать и в псевдографике (я даже программы видел для автоматического конвертирования html-таблиц)
FASM manual есть и на русском (правда, совсем не свежий)
Использование различных компиляторов в КолибриОС. Зачем в русской версии документации и русская, и английская статья?

III. Насчет онлайн-версии и поддержании в актуальном состоянии
Чем не нравится wiki, почему бы не синхронизировать все это?
Аккуратно подправить там главную страницу (давно пора изменить ссылки по разделам).
И время от времени новые и обновленные страницы из wiki добавлять в htm-версию

IV. О навигации
Копирайт на страницы добавлен везде с историей версий. А ссылочек "Назад, на главную, вперед" - очень жаль, что нет.


Top
   
PostPosted: Wed May 05, 2010 8:25 am 
Offline
User avatar

Joined: Wed Jan 27, 2010 10:59 am
Posts: 269
Исправил ошибки, о которых мне сообщили (и не только :D). Обновил документацию по FASM'у до версии 1.68 (раньше было 1.62).
Вот выпуск R4:
R4.7z - 407 447 байт

Albom wrote:
3) если перейти к документу в папке api, не работает ссылка внизу страницы ("История выпусков"). нужно изменить относительный путь.

К сожалению, HTMLv не поддерживает ссылки формата "../index.htm", поэтому есть два варианта развития событий: либо держать все страницы в одной папке, либо ждать когда Leency сделает поддержку в своем браузере :D.
Asper wrote:
Very good. :) Только вот хотелось бы какое-то выделение кода в тексте, в идеале подсветкой синтаксиса, как в fasmw.

Та же ситуация - либо идти через *опу и прописывать цвет в HTML-страницах, либо делать подсветку программно с помощью HTMLv +/- Tynipad

P.S.: Большое спасибо всем авторам и тестерам!

_________________
ушёл...


Last edited by Nasarus on Wed May 05, 2010 10:52 am, edited 2 times in total.

Top
   
PostPosted: Wed May 05, 2010 8:49 am 
Offline
User avatar

Joined: Wed Jan 27, 2010 10:59 am
Posts: 269
Sorcerer

Спасибо за совет. В версии R6 все сделаю как надо =)

_________________
ушёл...


Top
   
PostPosted: Wed May 05, 2010 8:53 am 
Offline
User avatar

Joined: Wed Jan 27, 2010 10:59 am
Posts: 269
Sorcerer wrote:
IV. О навигации
Копирайт на страницы добавлен везде с историей версий. А ссылочек "Назад, на главную, вперед" - очень жаль, что нет.

Я за копирайтом не гонюсь, просто лень было переделывать комментарий :D

_________________
ушёл...


Top
   
PostPosted: Wed May 05, 2010 10:54 am 
Offline
User avatar

Joined: Wed Jan 27, 2010 10:59 am
Posts: 269
Заменил "копирайт" на "Pterox' DocPack R4.1"
Attachment:
Clipboard02.jpg
Clipboard02.jpg [ 7.24 KiB | Viewed 4450 times ]

R4.1.7z - 407 451 байт
не гонюсь...

_________________
ушёл...


Top
   
PostPosted: Thu May 13, 2010 9:08 pm 
Offline
User avatar

Joined: Wed Jan 27, 2010 10:59 am
Posts: 269
Новый, 5-ый релиз документации. Главные плюсы: 1)в разделе "KolibriOS API" все ссылки теперь рабочие; 2) история версий разбита по номерам (спасибо Albom'у за совет). Остальные изменения читайте в спойлере ниже:
Spoiler: Show
1. Переделаны статьи "Лицензионное соглашение", "История версий Колибри OS"; licence.htm удален за ненадобностью
2. Переделаны страницы DocPack.htm (index.htm, соответсвенно)
3. История версий разбита на страницы (v0.7.7.0.htm, v.0.5.2.0 и т.д.)
4. Частично синхронизированы с wiki описания некоторых API-функций
5. Благодаря изменениям все ссылки в разделе "API" теперь работают.
6. Для удобства навигации содержимое папки API вернулось в папку Pages. По этой же причине там теперь лежит папка Data
7. Для удобства навигации в папке Pages теперь лежит копия файла DockPack.htm (index.htm)
8. Создан файл files.ini - группированый список файлов. Пока в нем только страницы описания API

Это скриншот:
Spoiler: Show
Attachment:
Screenshot.png
Screenshot.png [ 18.11 KiB | Viewed 4406 times ]

Ссылка:
Pterox' DocPack R5.7z - 409 416 байт

_________________
ушёл...


Top
   
Display posts from previous:  Sort by  
Post new topic  Reply to topic  [ 69 posts ]  Go to page Previous 1 2 3 4 5 Next

All times are UTC+03:00


Who is online

Users browsing this forum: No registered users and 2 guests


You cannot post new topics in this forum
You cannot reply to topics in this forum
You cannot edit your posts in this forum
You cannot delete your posts in this forum
You cannot post attachments in this forum

Search for:
Jump to:  
cron
Powered by phpBB® Forum Software © phpBB Limited