[FFmpeg-devel] [PATCH] doc: modify style for texi2html 1.78+

[Janne Grunau]

The generated HTML files are similar to the ones generated with
texi2html 1.56k used on the website.

Tested with texi2html 1.78 and 5.0. 1.78 is the minimal recommended
version.

The removed @sp from the titlepage section were ignored until
texi2html 5.0. If not removed the pages generated by 5.0 will have ugly
empty space around the title.
---
 Makefile             |    4 ++--
 doc/developer.texi   |    5 +++--
 doc/faq.texi         |    5 +++--
 doc/ffmpeg.texi      |    6 ++++--
 doc/ffplay.texi      |    6 ++++--
 doc/ffprobe.texi     |    6 ++++--
 doc/ffserver.texi    |    6 ++++--
 doc/general.texi     |    5 +++--
 doc/libavfilter.texi |    5 +++--
 doc/t2h_ffmpeg.init  |   24 ++++++++++++++++++++++++
 10 files changed, 54 insertions(+), 18 deletions(-)
 create mode 100644 doc/t2h_ffmpeg.init

diff --git a/Makefile b/Makefile
index c5e74f0..4a5c872 100644
--- a/Makefile
+++ b/Makefile
@@ -123,8 +123,8 @@ doc/ffprobe.pod doc/ffprobe.html: doc/demuxers.texi doc/indevs.texi doc/protocol
 doc/libavfilter.html: doc/filters.texi
 
 doc/%.html: TAG = HTML
-doc/%.html: doc/%.texi
-	$(M)cd doc && texi2html -monolithic -number $(<:doc/%=%)
+doc/%.html: doc/%.texi $(SRC_PATH_BARE)/doc/t2h_ffmpeg.init
+	$(M)cd doc && texi2html -monolithic --init-file $(SRC_PATH_BARE)/doc/t2h_ffmpeg.init $(<:doc/%=%)
 
 doc/%.pod: TAG = POD
 doc/%.pod: doc/%.texi
diff --git a/doc/developer.texi b/doc/developer.texi
index 89bc339..b9e246f 100644
--- a/doc/developer.texi
+++ b/doc/developer.texi
@@ -2,11 +2,12 @@
 
 @settitle Developer Documentation
 @titlepage
- at sp 7
 @center @titlefont{Developer Documentation}
- at sp 3
 @end titlepage
 
+ at top
+
+ at contents
 
 @chapter Developers Guide
 
diff --git a/doc/faq.texi b/doc/faq.texi
index c03a2e1..100adff 100644
--- a/doc/faq.texi
+++ b/doc/faq.texi
@@ -2,11 +2,12 @@
 
 @settitle FFmpeg FAQ
 @titlepage
- at sp 7
 @center @titlefont{FFmpeg FAQ}
- at sp 3
 @end titlepage
 
+ at top
+
+ at contents
 
 @chapter General Questions
 
diff --git a/doc/ffmpeg.texi b/doc/ffmpeg.texi
index 98f2031..047444a 100644
--- a/doc/ffmpeg.texi
+++ b/doc/ffmpeg.texi
@@ -2,11 +2,13 @@
 
 @settitle FFmpeg Documentation
 @titlepage
- at sp 7
 @center @titlefont{FFmpeg Documentation}
- at sp 3
 @end titlepage
 
+ at top
+
+ at contents
+
 @chapter Synopsis
 
 The generic syntax is:
diff --git a/doc/ffplay.texi b/doc/ffplay.texi
index c03905c..e0518b8 100644
--- a/doc/ffplay.texi
+++ b/doc/ffplay.texi
@@ -2,11 +2,13 @@
 
 @settitle FFplay Documentation
 @titlepage
- at sp 7
 @center @titlefont{FFplay Documentation}
- at sp 3
 @end titlepage
 
+ at top
+
+ at contents
+
 @chapter Synopsis
 
 @example
diff --git a/doc/ffprobe.texi b/doc/ffprobe.texi
index bc96bd5..de65eee 100644
--- a/doc/ffprobe.texi
+++ b/doc/ffprobe.texi
@@ -2,11 +2,13 @@
 
 @settitle FFprobe Documentation
 @titlepage
- at sp 7
 @center @titlefont{FFprobe Documentation}
- at sp 3
 @end titlepage
 
+ at top
+
+ at contents
+
 @chapter Synopsis
 
 The generic syntax is:
diff --git a/doc/ffserver.texi b/doc/ffserver.texi
index 77deb85..0cab3c8 100644
--- a/doc/ffserver.texi
+++ b/doc/ffserver.texi
@@ -2,11 +2,13 @@
 
 @settitle FFserver Documentation
 @titlepage
- at sp 7
 @center @titlefont{FFserver Documentation}
- at sp 3
 @end titlepage
 
+ at top
+
+ at contents
+
 @chapter Synopsys
 
 The generic syntax is:
diff --git a/doc/general.texi b/doc/general.texi
index c1fecef..950159f 100644
--- a/doc/general.texi
+++ b/doc/general.texi
@@ -2,11 +2,12 @@
 
 @settitle General Documentation
 @titlepage
- at sp 7
 @center @titlefont{General Documentation}
- at sp 3
 @end titlepage
 
+ at top
+
+ at contents
 
 @chapter external libraries
 
diff --git a/doc/libavfilter.texi b/doc/libavfilter.texi
index 8745928..f0b4482 100644
--- a/doc/libavfilter.texi
+++ b/doc/libavfilter.texi
@@ -2,11 +2,12 @@
 
 @settitle Libavfilter Documentation
 @titlepage
- at sp 7
 @center @titlefont{Libavfilter Documentation}
- at sp 3
 @end titlepage
 
+ at top
+
+ at contents
 
 @chapter Introduction
 
diff --git a/doc/t2h_ffmpeg.init b/doc/t2h_ffmpeg.init
new file mode 100644
index 0000000..cd38a3e
--- /dev/null
+++ b/doc/t2h_ffmpeg.init
@@ -0,0 +1,24 @@
+# no horiz rules between sections
+$end_section = \&FFMPEG_end_section;
+sub FFMPEG_end_section($$)
+{
+}
+
+$print_page_foot = \&FFMPEG_print_page_foot;
+sub FFMPEG_print_page_foot($$)
+{
+    my $fh = shift;
+    print $fh "$SMALL_RULE\n";
+    T2H_DEFAULT_print_page_foot($fh);
+}
+
+# no navigation elements
+$SECTION_NAVIGATION = 0;
+# the same for texi2html 5.0
+$HEADERS = 0;
+
+# TOC and Chapter headings link
+$TOC_LINKS = 1;
+
+# print the TOC where @contents is used
+$INLINE_CONTENTS = 1;
-- 
1.7.4.rc2