EduMandriva

форум российского сообщества Edumandriva

Форум предназначен для обсуждения вопросов проекта Edumandriva. По вопросам дистрибутивов Mandriva и РОСА просьба обращаться на forum.rosalab.ru, unixforum.org и linuxforum.ru

Текущее время: 06 дек 2019 00:58

Часовой пояс: UTC + 3 часа [ Летнее время ]




Начать новую тему Ответить на тему  [ Сообщений: 6 ] 
Автор Сообщение
 Заголовок сообщения: Начало проекта документирования 2011
СообщениеДобавлено: 15 сен 2011 23:48 
Аватара пользователя

Зарегистрирован: 20 апр 2010 18:22
Сообщения: 826
Начинаем проект документирования.

Проект будет использовать ASCIIDOC и экспорт в разные форматы.

Сейчас надо решить вопрос по html версии - какой вариант лучше:

http://edumandriva.ru/doc/edumandriva/2 ... -book.html

или

http://edumandriva.ru/doc/edumandriva/2 ... index.html

Генерируемый pdf: http://edumandriva.ru/doc/edumandriva/2 ... e-book.pdf

Также предлагаю обсудить следующее:

1) нужен ли экспорт в вики страницы и получение книг в таком формате (http://edumandriva.ru/wiki/index.php/%D ... 0%B8%D1%8F) в pdf и odt, или достаточно будет просто генерации pdf (пока еще не настроена нормально)?
2) какие главы нужны в руководстве (учитываем использование руководств под обычные Mandriva также)?


Вернуться к началу
 Профиль  
 
 Заголовок сообщения: Re: Начало проекта документирования 2011
СообщениеДобавлено: 15 сен 2011 23:54 
Аватара пользователя

Зарегистрирован: 07 окт 2010 03:30
Сообщения: 1482
По html версии: У обоих вариантов свои плюсы и минусы, но второй вариант выглядит, как старые how-to, которые никто не читает и в них можно заблудиться,  первый вариант более интересен(выглядит как миниобзор, которые всегда  любопытно почитать)


Вернуться к началу
 Профиль  
 
 Заголовок сообщения: Re: Начало проекта документирования 2011
СообщениеДобавлено: 16 сен 2011 00:00 
Аватара пользователя

Зарегистрирован: 20 апр 2010 18:22
Сообщения: 826
Я просто хочу создать систему документирования, которую можно будет предложить сообществу, включая возможность коллективного написания и перевода. ASCIIDOC кажется мне оптимальным. Надо будет еще доработать make систему и развернуть сервер доступа и написания документации :)


Вернуться к началу
 Профиль  
 
 Заголовок сообщения: Re: Начало проекта документирования 2011
СообщениеДобавлено: 16 сен 2011 12:24 

Зарегистрирован: 19 окт 2010 14:51
Сообщения: 105
Первый вариант более интересный. :)
Второй хорошо будет работать на машинах с узким каналом в инет.


Вернуться к началу
 Профиль  
 
 Заголовок сообщения: Re: Начало проекта документирования 2011
СообщениеДобавлено: 17 сен 2011 12:56 
Аватара пользователя

Зарегистрирован: 07 фев 2010 19:31
Сообщения: 784
А есть возможность из одного варианта автоматом делать другой? Это самый лучший способ: хочешь скорости (медленный, дорогой интернет) - смотри второй; хочешь красоты (хороший, дешёвый канал) - смотри первый.

_________________
:crazy_pilot:


Вернуться к началу
 Профиль  
 
 Заголовок сообщения: Re: Начало проекта документирования 2011
СообщениеДобавлено: 17 сен 2011 14:20 
Аватара пользователя

Зарегистрирован: 20 апр 2010 18:22
Сообщения: 826
Только параллельно. Мы можем генерить из одних исходников пока html, html5, docbook, pdf, tex


Вернуться к началу
 Профиль  
 
Показать сообщения за:  Поле сортировки  
Начать новую тему Ответить на тему  [ Сообщений: 6 ] 

Часовой пояс: UTC + 3 часа [ Летнее время ]


Кто сейчас на конференции

Сейчас этот форум просматривают: нет зарегистрированных пользователей


Вы не можете начинать темы
Вы не можете отвечать на сообщения
Вы не можете редактировать свои сообщения
Вы не можете удалять свои сообщения
Вы не можете добавлять вложения

Найти:
Перейти:  
cron
Powered by phpBB © 2000, 2002, 2005, 2007 phpBB Group
Русская поддержка phpBB