Board.KolibriOS.org

Official KolibriOS board
It is currently Thu Feb 20, 2020 2:27 pm

All times are UTC+03:00




Post new topic  Reply to topic  [ 69 posts ]  Go to page 1 2 3 4 5 Next
Author Message
 Post subject: KolibriOS Documentation
PostPosted: Wed Apr 28, 2010 5:11 pm 
Offline
User avatar

Joined: Wed Jan 27, 2010 10:59 am
Posts: 269
Привет всем форумчанам! Я начинаю проект по созданию полноценной HTML документации, которая предназначена для просмотра прямо из-под Колибри, и ориентированная как на простых пользователей, так и на программистов. Предлагаю писать здесь ваши пожелания, критику, замеченные вами ошибки и недочеты и т.д. Ни чье сообщение не будет проигнорировано =).
Выкладываю первую обновленную, так сказать альфа версию. Теперь в ней есть: три выпуска "Вестника", мануал по написанию драйверов и по программированию на ЯВУ от Diamond'а. Также было улучшена верстка (не намного :lol:). Вот, собственно, сама документация:
http://ifolder.ru/17493867
Извиняюсь за внешнюю ссылку, но больше 256 КБ вложить не получается, а архив весит 443 КБ.
Спасибо за внимание!

_________________
ушёл...


Top
   
PostPosted: Thu Apr 29, 2010 12:01 am 
Offline
User avatar

Joined: Wed Jan 27, 2010 10:59 am
Posts: 269
Вот теперь выглядит заглавная страница:
Attachment:
Screenshot.png
Screenshot.png [ 61.98 KiB | Viewed 7391 times ]

_________________
ушёл...


Top
   
PostPosted: Thu Apr 29, 2010 9:36 am 
Хорошая работа. Несколько дополнений:
1) Попроси у mike.dld доступ к ftp. Скачивать с ifolder не самое приятное занятие.
2) Все GIF можно пережать в PNG, при том же качестве изображение экономия 20-40% в размере. Если пропустить через очистительные программы (смотри пост Leency), то думаю еще меньше станут.
3) Если пропустить HTML файлы через ВебЛомастер - они опять же становятся меньше.


Top
   
PostPosted: Thu Apr 29, 2010 12:40 pm 
Offline
Designer
User avatar

Joined: Thu Jan 25, 2007 3:33 pm
Posts: 5083
Выглядит очень привлекательно :)

_________________
Через тернии к звездам


Top
   
PostPosted: Thu Apr 29, 2010 1:06 pm 
Offline

Joined: Mon Sep 24, 2007 11:11 am
Posts: 2814
Когда-то пытался сделать то же самое, но остановился из-за того, что картинки наезжают на заголовок.
Интересное решение получилось, мне нравится. :wink:
Если нужны будут какие-то тексты (кроме того, у меня были заготовки руководства пользователя), пиши в личку, а лучше в асю.


Top
   
PostPosted: Thu Apr 29, 2010 1:25 pm 
Offline
Mentor
User avatar

Joined: Tue Jan 15, 2008 11:27 am
Posts: 753
Неплохо было бы в конце каждой страницы иметь ссылку на главную.
Если я правильно понял, в подборке 1-го номера вестника нет, есть только критические замечания.


Top
   
PostPosted: Thu Apr 29, 2010 1:47 pm 
Offline
User avatar

Joined: Wed Jan 27, 2010 10:59 am
Posts: 269
Mario, Leency, Sorcerer
Спасибо =)
Sorcerer
Спс за предложение, постараюсь включить твои мануалы в следующий выпуск.

Albom wrote:
Неплохо было бы в конце каждой страницы иметь ссылку на главную.

Обязательно сделаю, как только руки дойдут :D
Albom wrote:
Если я правильно понял, в подборке 1-го номера вестника нет, есть только критические замечания.

Нет. Просто сначала идет ссылка на первый выпуск, а потом на критику. Сглупил, конечно. В следующий раз, разделю их для удобочитаемости :)

_________________
ушёл...


Top
   
PostPosted: Thu Apr 29, 2010 2:29 pm 
Offline
User avatar

Joined: Wed Jan 27, 2010 10:59 am
Posts: 269
Вот нормальная ссылка:
http://ftp.kolibrios.org/users/Nasarus/KolibriOS%20Documentation%20(0.7.7.0+).7z

P.S.: Архив стал легче на 100 КБ - конвертнул GIF рисунки в PNG :)

_________________
ушёл...


Top
   
PostPosted: Sun May 02, 2010 4:05 pm 
Offline
User avatar

Joined: Wed Jan 27, 2010 10:59 am
Posts: 269
Здравствуйте! Если кому интересно, то развитие документации будет осуществятся таким способом:

1-ая стадия. Объединение всей существующей документации без излишнего дублирования. Создание единой системы, наподобие Википедии, но онлайн-независимой. Определение концепции :)
2-ая стадия (надеюсь не завершаемая). Наполнение документации новой информацией, постоянные обновления. Поиск и исправление ошибок, регулярные ревизии =)
3-ья стадия(параллельно со 2-ой). Переход на новый уровень: реализация онлайновой версии документации, создание специальных программ по работе с оффлайновой (типа удобного справочника API+вся техническая инфа для программирования в Колибри, типа MKTH). Создание специального сайта :D + что то вроде багзиллы. И еще многое другое )


Также вся документация будет выходить под лизенцией GNU FDL, а примеры кода к ней под GNU GPL. Так что если чьи-то статьи или другая инфа попадут в выпуск и автор не будет согласен с условиями распространения, первый, собственно, будут удалятся.


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

_________________
ушёл...


Top
   
PostPosted: Sun May 02, 2010 9:09 pm 
Offline
User avatar

Joined: Wed Jan 27, 2010 10:59 am
Posts: 269
Как вы считаете такой логотип подойдет?

В виде иконки:
//Тут когда-то была стрёмная иконка\\
Крупный план:
//А тут когда-то была стрёмная картинка\\

_________________
ушёл...


Last edited by Nasarus on Wed Jul 21, 2010 2:54 pm, edited 2 times in total.

Top
   
PostPosted: Sun May 02, 2010 11:46 pm 
Offline
Mentor
User avatar

Joined: Tue Jan 15, 2008 11:27 am
Posts: 753
чё-та на свастику смахивает... может, всё-таки один знак вопроса оставить? (да, неоригинально, зато интуитивно понятно...)


Top
   
PostPosted: Mon May 03, 2010 12:05 am 
Offline
User avatar

Joined: Wed Jan 27, 2010 10:59 am
Posts: 269
Albom wrote:
чё-та на свастику смахивает... может, всё-таки один знак вопроса оставить? (да, неоригинально, зато интуитивно понятно...)

И вправду смахивает =) Я только сейчас заметил. Ну ладно, исправимся ;)

_________________
ушёл...


Top
   
PostPosted: Mon May 03, 2010 12:27 am 
Offline
Designer
User avatar

Joined: Thu Jan 25, 2007 3:33 pm
Posts: 5083
Если такой логотип с 4 знаками вопроса, то точку "снизу" должна быть одна для каждого знака, а не 4 наложенные друг на дгруга.

_________________
Через тернии к звездам


Top
   
PostPosted: Mon May 03, 2010 7:31 am 
Offline
User avatar

Joined: Wed Jan 27, 2010 10:59 am
Posts: 269
Leency wrote:
Если такой логотип с 4 знаками вопроса, то точку "снизу" должна быть одна для каждого знака, а не 4 наложенные друг на дгруга.

Так сначала и было задумано =) Но я отказался от этого варианта. Будет время сделаю другой, благо некоторые соображения уже есть: иконка и лого будут отличатся, и графика будет минималистская ))

_________________
ушёл...


Top
   
PostPosted: Mon May 03, 2010 8:58 am 
Offline
User avatar

Joined: Wed Jan 27, 2010 10:59 am
Posts: 269
Вот такие получились иконки. Слева на право: 16x16, 32x32, 64x64, 128x128. Это GIF'ки сохраненные в PNG, поэтому значок размером 32x32 также будет выглядеть и в Колибри (оттенки серого для того, чтобы при сохранении в GIF не терялось качество)
Attachment:
XD.png
XD.png [ 8.14 KiB | Viewed 7260 times ]

_________________
ушёл...


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

All times are UTC+03:00


Who is online

Users browsing this forum: No registered users and 1 guest


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:  
Powered by phpBB® Forum Software © phpBB Limited