[sisyphus] Вопрос по документации ALT

[sisyphus] Вопрос по документации ALT

[Alexei V. Mezin]

Hello ALT,

  Я верно понял, что в ALT всю документацию пишут в docbook?
  Где посмотреть пример использования DTD? А так же чем принято
  проверять корректность получившегося xml и чем конвертировать его в
  PS/PDF (если можно, то с примерами)?

-- 
Best regards,
 Alexei V. Mezin                          mailto:mezin@ntmdt.ru

Re: [sisyphus] Вопрос по документации ALT

[Anton Farygin]

Alexei V. Mezin wrote:

>Hello ALT,
>
>  Я верно понял, что в ALT всю документацию пишут в docbook?
>  Где посмотреть пример использования DTD? А так же чем принято
>  проверять корректность получившегося xml и чем конвертировать его в
>  PS/PDF (если можно, то с примерами)?
>
>  
>
Есть список рассылки docs@altlinux.ru - задайте этот вопрос там.

Rgds,
Rider

[sisyphus] Re: [offtopic] Вопрос по документации ALT

[Vitaly Ostanin]

[-- Attachment #1: Type: text/plain, Size: 738 bytes --]

Anton Farygin пишет:
> Alexei V. Mezin wrote:
>
>
>>Hello ALT,
>>
>> Я верно понял, что в ALT всю документацию пишут в docbook?
>> Где посмотреть пример использования DTD? А так же чем принято
>> проверять корректность получившегося xml и чем конвертировать его в
>> PS/PDF (если можно, то с примерами)?
>>
>>
>>
>
> Есть список рассылки docs@altlinux.ru - задайте этот вопрос там.

Список не доступен для подписки всем желающим - в надежде
предотвратить флейм туда подписывают только практически
работающих над документацией. Надежда в последнее время не
оправдалась, но начать лучше с
http://docs.altlinux.ru/beta/alt/ch03.html
и письма на
joindocs@altlinux.ru

<skipped/>

--
Regards, Vyt
mailto:  vyt@vzljot.ru
JID:     vyt@vzljot.ru

[-- Attachment #2: OpenPGP digital signature --]
[-- Type: application/pgp-signature, Size: 256 bytes --]

Re[2]: [sisyphus] Вопрос по документации ALT

[Alexei V. Mezin]

Hello Anton,

Thursday, February 17, 2005, 2:37:10 PM, you wrote:

AF> Alexei V. Mezin wrote:

>>Hello ALT,
>>
>>  Я верно понял, что в ALT всю документацию пишут в docbook?
>>  Где посмотреть пример использования DTD? А так же чем принято
>>  проверять корректность получившегося xml и чем конвертировать его в
>>  PS/PDF (если можно, то с примерами)?
>>
>>  
>>
AF> Есть список рассылки docs@altlinux.ru - задайте этот вопрос там.

Цитата с altlinux.ru по поводу docs@altlinux:
"Это закрытый список рассылки". Т.е. нужна регистрация, доступ в CVS и
прочее... Я пока не считаю себя готовым туда подписаться.



-- 
Best regards,
 Alexei V. Mezin                            mailto:mezin@ntmdt.ru

Re: Re[2]: [sisyphus] Вопрос по до кументации ALT

[Alexandre Prokoudine]

On Thu, 17 Feb 2005 15:26:13 +0300, Alexei V. Mezin <mezin@ntmdt.ru> wrote:

> Цитата с altlinux.ru по поводу docs@altlinux:
> "Это закрытый список рассылки". Т.е. нужна регистрация, доступ в CVS и
> прочее... Я пока не считаю себя готовым туда подписаться.

Где в этой цитате написано про доступ в CVS?

А.П.

Re[4]: [sisyphus] Вопрос по до кументации ALT

[Alexei V. Mezin]

Hello Alexandre,

Thursday, February 17, 2005, 3:37:21 PM, you wrote:

AP> On Thu, 17 Feb 2005 15:26:13 +0300, Alexei V. Mezin <mezin@ntmdt.ru> wrote:

>> Цитата с altlinux.ru по поводу docs@altlinux:
>> "Это закрытый список рассылки". Т.е. нужна регистрация, доступ в CVS и
>> прочее... Я пока не считаю себя готовым туда подписаться.

AP> Где в этой цитате написано про доступ в CVS?
Имелось ввиду, что после регистрации будет доступен CVS. А оно мне
сейчас надо? Просто хочу разобраться, в каком формате в ALT готовят
документацию. Чтоб проверить свои силы и т.п. И когда созрею для более
плотной работы "в коллективе", вот тогда и надо будет доступ к дереву
документации и т.п.

Или сведения про формат и способы его использования -- это секрет
фирмы, доступный только избранным?



-- 
Best regards,
 Alexei V. Mezin                            mailto:mezin@ntmdt.ru

[sisyphus] Re: Вопрос по до кументации ALT

[Vitaly Ostanin]

[-- Attachment #1: Type: text/plain, Size: 959 bytes --]

Alexei V. Mezin пишет:
> Hello Alexandre,
>
> Thursday, February 17, 2005, 3:37:21 PM, you wrote:
>
> AP> On Thu, 17 Feb 2005 15:26:13 +0300, Alexei V. Mezin <mezin@ntmdt.ru> wrote:
>
>
>>>Цитата с altlinux.ru по поводу docs@altlinux:
>>>"Это закрытый список рассылки". Т.е. нужна регистрация, доступ в CVS и
>>>прочее... Я пока не считаю себя готовым туда подписаться.
>
>
> AP> Где в этой цитате написано про доступ в CVS?
> Имелось ввиду, что после регистрации будет доступен CVS. А оно мне
> сейчас надо? Просто хочу разобраться, в каком формате в ALT готовят
> документацию. Чтоб проверить свои силы и т.п. И когда созрею для более
> плотной работы "в коллективе", вот тогда и надо будет доступ к дереву
> документации и т.п.
>
> Или сведения про формат и способы его использования -- это секрет
> фирмы, доступный только избранным?

Прочитайте остальные сообщения в этом треде.

<skipepd/>

--
Regards, Vyt
mailto:  vyt@vzljot.ru
JID:     vyt@vzljot.ru

[-- Attachment #2: OpenPGP digital signature --]
[-- Type: application/pgp-signature, Size: 256 bytes --]

[sisyphus] Re[2]: Вопрос по до кументации ALT

[Alexei V. Mezin]

Hello Vitaly,

Thursday, February 17, 2005, 3:58:59 PM, you wrote:


VO> Прочитайте остальные сообщения в этом треде.
Прочитал. Советуют сходить по ссылке, подписаться на закрытый список и т.п.

Еще раз попробую объяснить:
- я не хочу (пока) подключаться к docs@, хватает и веб-архива
- я не хочу (пока) вносить свою наработки в CVS/Кучу
- я не хочу скачать из CVS горы документации
- я просто хочу посмотреть на пример оформления документации в ALT,
чтобы было на основании чего изучать docbook/разработку документации
ALT. Например, есть у меня настроение и лишних полчаса и я готов
написать небольшой текст "документации", и при этом хочу сделать сразу
в том формате, в котором в перспективе можно будет наработки перенести
в общее пользование.




-- 
Best regards,
 Alexei V. Mezin                            mailto:mezin@ntmdt.ru

Re: [sisyphus] Re[2]: Вопрос по до кумента ции ALT

[Alexandre Prokoudine]

On Thu, 17 Feb 2005 16:20:18 +0300, Alexei V. Mezin <mezin@ntmdt.ru> wrote:
> Hello Vitaly,
> 
> Thursday, February 17, 2005, 3:58:59 PM, you wrote:
> 
> VO> Прочитайте остальные сообщения в этом треде.
> Прочитал. Советуют сходить по ссылке, подписаться на закрытый список и т.п.
> 
> Еще раз попробую объяснить:
> - я не хочу (пока) подключаться к docs@, хватает и веб-архива
> - я не хочу (пока) вносить свою наработки в CVS/Кучу
> - я не хочу скачать из CVS горы документации
> - я просто хочу посмотреть на пример оформления документации в ALT,
> чтобы было на основании чего изучать docbook/разработку документации
> ALT. Например, есть у меня настроение и лишних полчаса и я готов
> написать небольшой текст "документации", и при этом хочу сделать сразу
> в том формате, в котором в перспективе можно будет наработки перенести
> в общее пользование.

Алексей, в Sisyphus есть пакеты как с самой документацией, так и с
XSL-стилями. Изучайте на здоровье :)

А.П.

Re[2]: [sisyphus] Re[2]: Вопрос по до кумента ции ALT

[Alexei V. Mezin]

Hello Alexandre,

Thursday, February 17, 2005, 4:15:21 PM, you wrote:

AP> Алексей, в Sisyphus есть пакеты как с самой документацией, так и с
AP> XSL-стилями. Изучайте на здоровье :)
Подскажите, в каком именно пакете есть пример документации? А то
просто так ничего не нашлось.




-- 
Best regards,
 Alexei V. Mezin                            mailto:mezin@ntmdt.ru

Re: [sisyphus] Re[2]: Вопрос по до кумента ции ALT

[Vitaly Ostanin]

[-- Attachment #1: Type: text/plain, Size: 611 bytes --]

Alexei V. Mezin пишет:
> Hello Alexandre,
>
> Thursday, February 17, 2005, 4:15:21 PM, you wrote:
>
> AP> Алексей, в Sisyphus есть пакеты как с самой документацией, так и с
> AP> XSL-стилями. Изучайте на здоровье :)
> Подскажите, в каком именно пакете есть пример документации? А то
> просто так ничего не нашлось.

Я понимаю, что сходить по ссылке тяжело, но вы напрягитесь :)
http://docs.altlinux.ru/beta/alt/ch03s06.html

Но вообще документацию берут в любом формате. Архивы
docs@altlinux.ru открыты и google тоже не особо секретен.

<skipped/>

--
Regards, Vyt
mailto:  vyt@vzljot.ru
JID:     vyt@vzljot.ru

[-- Attachment #2: OpenPGP digital signature --]
[-- Type: application/pgp-signature, Size: 256 bytes --]

Re: [sisyphus] Re[2]: Вопрос по до кумента ции ALT

[Alexandre Prokoudine]

On Thu, 17 Feb 2005 16:57:37 +0300, Vitaly Ostanin <vyt@vzljot.ru> wrote:
> Alexei V. Mezin пишет:
> > Hello Alexandre,
> >
> > Thursday, February 17, 2005, 4:15:21 PM, you wrote:
> >
> > AP> Алексей, в Sisyphus есть пакеты как с самой документацией, так и с
> > AP> XSL-стилями. Изучайте на здоровье :)
> > Подскажите, в каком именно пакете есть пример документации? А то
> > просто так ничего не нашлось.
> 
> Я понимаю, что сходить по ссылке тяжело, но вы напрягитесь :)
> http://docs.altlinux.ru/beta/alt/ch03s06.html 

Справедливости ради отмечу, что 

    <author lang="en">
      <firstname>Vitaly</firstname>
      <surname>Ostanin</surname>
      <affiliation>
        <address>
          <email>vyt@altlinux.ru</email>
          <otheraddr>JID: vyt@vzljot.ru</otheraddr>
        </address>
      </affiliation>
    </author>

-- явно устаревший для проекта способ указать автора.

Может всё-таки стоит обновить доки на сайте?

А.П.

[sisyphus] Re: Вопрос по документации ALT

[Vitaly Ostanin]

[-- Attachment #1: Type: text/plain, Size: 1761 bytes --]

Alexandre Prokoudine пишет:
> On Thu, 17 Feb 2005 16:57:37 +0300, Vitaly Ostanin <vyt@vzljot.ru> wrote:
>
>>Alexei V. Mezin пишет:
>>
>>>Hello Alexandre,
>>>
>>>Thursday, February 17, 2005, 4:15:21 PM, you wrote:
>>>
>>>AP> Алексей, в Sisyphus есть пакеты как с самой документацией, так и с
>>>AP> XSL-стилями. Изучайте на здоровье :)
>>>Подскажите, в каком именно пакете есть пример документации? А то
>>>просто так ничего не нашлось.
>>
>>Я понимаю, что сходить по ссылке тяжело, но вы напрягитесь :)
>>http://docs.altlinux.ru/beta/alt/ch03s06.html
>
>
> Справедливости ради отмечу, что
>
>     <author lang="en">
>       <firstname>Vitaly</firstname>
>       <surname>Ostanin</surname>
>       <affiliation>
>         <address>
>           <email>vyt@altlinux.ru</email>
>           <otheraddr>JID: vyt@vzljot.ru</otheraddr>
>         </address>
>       </affiliation>
>     </author>
>
> -- явно устаревший для проекта способ указать автора.

Так кто ж спорит...

> Может всё-таки стоит обновить доки на сайте?

Обновить доки, описывающие устаревшую систему сборки ;) Мне
сейчас важнее обновить систему сборки, sorry.

К тому же в доксе недавно была волна радужного оптимизма, и с
этим справятся без меня :)

<skipped/>

--
Regards, Vyt
mailto:  vyt@vzljot.ru
JID:     vyt@vzljot.ru

[-- Attachment #2: OpenPGP digital signature --]
[-- Type: application/pgp-signature, Size: 256 bytes --]

Re: Re[4]: [sisyphus] Вопрос по до кументации ALT

[Alexandre Prokoudine]

On Thu, 17 Feb 2005 16:02:32 +0300, Alexei V. Mezin <mezin@ntmdt.ru> wrote:

> Или сведения про формат и способы его использования -- это секрет
> фирмы, доступный только избранным?

http://docs.altlinux.ru/alt/devel/ch03s02.html - Инструменты для
создания документов
http://docs.altlinux.ru/alt/devel/ch03s03.html - Преобразование в другие форматы
http://docs.altlinux.ru/alt/devel/ch03s06.html - Образец документа в DocBook

Корневой документ с содержанием: http://docs.altlinux.ru/alt/devel/ch03.html

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

А.П.

Re[6]: [sisyphus] Вопрос по до кументации ALT

[Alexei V. Mezin]

Hello Alexandre,

Thursday, February 17, 2005, 4:40:04 PM, you wrote:

AP> On Thu, 17 Feb 2005 16:02:32 +0300, Alexei V. Mezin <mezin@ntmdt.ru> wrote:


AP> http://docs.altlinux.ru/alt/devel/ch03s02.html - Инструменты для
AP> создания документов
AP> http://docs.altlinux.ru/alt/devel/ch03s03.html -
AP> Преобразование в другие форматы
AP> http://docs.altlinux.ru/alt/devel/ch03s06.html - Образец документа в DocBook
Спасиба :)




-- 
Best regards,
 Alexei V. Mezin                            mailto:mezin@ntmdt.ru

Re: [sisyphus] Вопрос по документации ALT

[Alexandre Prokoudine]

On Thu, 17 Feb 2005 14:03:19 +0300, Alexei V. Mezin <mezin@ntmdt.ru> wrote:
> Hello ALT,
> 
>   Я верно понял, что в ALT всю документацию пишут в docbook?
>   Где посмотреть пример использования DTD? А так же чем принято
>   проверять корректность получившегося xml и чем конвертировать его в
>   PS/PDF (если можно, то с примерами)?

http://docs.altlinux.ru/alt/devel/ch03s10.html

Кстати, ссылка на эту страницу есть в описании списка рассылки :)

А.П.

[sisyphus] Re: Вопрос по документации ALT

[Arioch]

Alexei V. Mezin пишет:
> Hello ALT,
> 
>   Я верно понял, что в ALT всю документацию пишут в docbook?

http://offline.computerra.ru/2005/578/37629/ ;)