Re: [ANN] Media documentation converted to ReST markup language

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



Em Sat, 09 Jul 2016 20:10:21 +0300
Laurent Pinchart <laurent.pinchart@xxxxxxxxxxxxxxxx> escreveu:

> The other one is related, the table of contents in the main page of each 
> section 
> (https://mchehab.fedorapeople.org/media_API_book/linux_tv/media/v4l/v4l2.html 
> for instance) only shows the first level entries. We have a full table of 
> contents now, and that's very practical to quickly search for the information 
> we need without requiring many clicks (or actually any click at all). How can 
> we keep that feature ?

It is not hard to change the level of entries, although I really hated the
DocBook template that creates multi-depth TOCs everywhere, as it is very
messy to see those big indexes in the middle of the book.

What I did was to add *one* full contents index (actually, up to level 5)
at the first page of the book:
	https://linuxtv.org/downloads/v4l-dvb-apis-new/media/media_uapi.html

and kept the other ones with depth 1.

> 
> By the way, the "Video for Linux API" section (and the other sibling sections) 
> are child nodes of the "Introduction" section. That feels quite odd.


This was fixed already.

Thanks,
Mauro
--
To unsubscribe from this list: send the line "unsubscribe linux-doc" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at  http://vger.kernel.org/majordomo-info.html



[Index of Archives]     [Kernel Newbies]     [Security]     [Netfilter]     [Bugtraq]     [Linux FS]     [Yosemite Forum]     [MIPS Linux]     [ARM Linux]     [Linux Security]     [Linux RAID]     [Samba]     [Video 4 Linux]     [Device Mapper]     [Linux Resources]

  Powered by Linux