Re: Table of Contents always after copying section in html output
Thanks for the tip. I have now the wished layout. https://cuis-smalltalk.github.io/TheCuisBook Le 30/12/2023 à 18:13, Patrice Dumas a écrit : On the command line, that would be: texi2any --html -c CONTENTS_OUTPUT_LOCATION=inline manual.texi -- GNU Dr. Geo http://gnu.org/s/dr-geo/ http://gnu-drgeo.blogspot.com/
Re: How to avoid mini toc in HTML output
Thanks Patrice, menu option does what I need. Then I have the menu only when I define it in the documentation source. So, it still shows up in the linked example below. The issue with the default option of html rendering is that you get menu even when not requested and it can pop up in the middle of your documentation, depending on how your write documentation in the section. I prefer the way the menu is rendered with sectiontoc option, though, with ul and li tags instead of table. But it will be fine. Hilaire Le 30/12/2023 à 18:38, Patrice Dumas a écrit : How the 'menus' are formatted depend on FORMAT_MENU customization variable, which is now 'sectiontoc' by default. It is possible to get back to menu, by setting FORMAT_MENU to menu. From the command line: texi2any --html -c FORMAT_MENU=menu manual.texi or remove completly any type of menu by setting FORMAT_MENU to nomenu: texi2any --html -c FORMAT_MENU=nomenu manual.texi But it is not clear to me that it is what you want, as it seems to me that a mini-toc or a menu is needed in some cases for navigation, as in the following page: https://cuis-smalltalk.github.io/TheCuisBook/The-Fundamentals-of-Morph.html -- GNU Dr. Geo http://gnu.org/s/dr-geo/ http://gnu-drgeo.blogspot.com/
Table of Contents always after copying section in html output
Hi, Since upgrading to texinfo 7.0.3, when rendering html, the table of contents always appears after the copying, even if instructed differently. Thanks Hilaire See https://cuis-smalltalk.github.io/TheCuisBook/index.html From source: \input texinfo @c -*-texinfo-*- @c %**start of header @include ../bookSettings.texinfo @include copying.texinfo @c %**end of header @titlepage @title The @cuis{} book @subtitle Introduction to Programming with Smalltalk @* @* @* @* @alanQuoteAboutCuis @author @writers{} @iftex @page @vskip 0pt plus 1filll @insertcopying @end iftex @end titlepage @iftex @shortcontents @contents @end iftex @node Top @ifnottex @alanQuoteAboutCuis @* Cuis is a free Smalltalk-80 environment with a specific set of goals: being simple and powerful. It is also portable to any platform, fast and efficient. @* You are reading the Cuis Book! @top Table of Contents @insertcopying @end ifnottex @menu * Preface:: * Beginnings:: * The Message Way of Life:: * Class - Model of Communicating Entities:: * The Collection Way of Life:: * Control Flow Messaging:: * Visual with Morph:: * The Fundamentals of Morph:: * Events:: * Code Management:: * Debug and Exception Handling:: * Sharing Cuis:: * Documents Copyright:: * Summary of Syntax:: * The Exercises:: * Solutions to the Exercises:: * The Examples:: * The Figures:: * Spacewar! Source Code:: * Indexes:: @end menu @tex \global\parskip=0.5em @end tex @c @c Preface @include chapter-00/contents.texinfo @c @c:Part One @c @part Part One @*The basis of @cuis{} @c @include chapter-01/contents.texinfo @c @include chapter-02/contents.texinfo @c @include chapter-03/contents.texinfo @c @include chapter-04/contents.texinfo @c @include chapter-05/contents.texinfo @c @include chapter-06/contents.texinfo @c @include chapter-07/contents.texinfo @c @include chapter-08/contents.texinfo @c @include chapter-09/contents.texinfo @c @include chapter-10/contents.texinfo @c @include chapter-11/contents.texinfo @c @c: Part Four @c @part Part Four @*Appendices @c Copyrighted document used in the book @include copyrights.texinfo @c Summary of syntax @include syntaxSummary.texinfo @c List of exercises @node The Exercises @appendix The Exercises @listoffloats Exercise @c Solutions of exercises @include chapter-50/contents.texinfo @c List of examples @node The Examples @appendix The Examples @listoffloats Example @c List of figures @node The Figures @appendix The Figures @listoffloats Figure @c The Spacewar source code @node Spacewar! Source Code @appendix Spacewar! Source Code In the raw source code below, understand the ``_'' character as ``@assign{}''. @smallformat @verbatiminclude ../Spacewar!.pck.st @end smallformat @c Indexes @node Indexes @appendix Conceptual index @printindex cp @c @c: To be filled @c:END OF THE BOOK @bye -- GNU Dr. Geo http://gnu.org/s/dr-geo/ http://gnu-drgeo.blogspot.com/
How to avoid mini toc in HTML output
Hi folks, I just upgraded some documentation to 7.x. How can I avoid the mini-toc in the middle of the html document. See in the examples below. The first example is really confusing. https://cuis-smalltalk.github.io/TheCuisBook/Daily-Workflow.html#Automate-your-image https://cuis-smalltalk.github.io/TheCuisBook/Going-Vector.html Of course the main table of contents is still needed. Thanks Hilaire -- GNU Dr. Geo http://gnu.org/s/dr-geo/ http://gnu-drgeo.blogspot.com/
Re: Changing emphasis in example
Oh, you are right! It is just that my eyes can't see much of the difference. May be increasing the font size will be needed too. I don't think it is possible, don't you? Thanks Le 26/12/2020 à 10:21, Gavin Smith a écrit : To be more accurate: its does not work with the PDF output (the command @b{} has no effect in example bloc) however it works with the HTML output. I need it works with the PDF output too. Odd, works for me. See attachment. Are you using the latest version of texinfo.tex? -- GNU Dr. Geo http://drgeo.eu https://pouet.chapril.org/@hilaire
Re: Changing emphasis in example
To be more accurate: its does not work with the PDF output (the command @b{} has no effect in example bloc) however it works with the HTML output. I need it works with the PDF output too. texinfo 6.7.0. Thanks Hilaire Le 25/12/2020 à 11:59, Hilaire Fernandes a écrit : Hello, In an example block, I would like to mark some text as strong. It does not work however. @example @b{H}ello @end example Any idea? Thanks Merry Christmas! Hilaire -- GNU Dr. Geo http://drgeo.eu https://pouet.chapril.org/@hilaire
Changing emphasis in example
Hello, In an example block, I would like to mark some text as strong. It does not work however. @example @b{H}ello @end example Any idea? Thanks Merry Christmas! Hilaire -- GNU Dr. Geo http://drgeo.eu https://pouet.chapril.org/@hilaire
ICONS customize variable
Hello, I set this variable to true, but it does not insert icons in the navigation bar. There is no error though and the html source does not show difference in the navigation part. texi2any -c ICONS=true -I $imgPath --output=$htmlDest/ --html --css-ref=style.css $masterDoc texinfo 6.7.0 Thanks -- GNU Dr. Geo http://drgeo.eu https://pouet.chapril.org/@hilaire
Re: Paragraph vertical space
I wrote it too early in the document source tree. Fine now. Thanks! Hilaire -- GNU Dr. Geo http://drgeo.eu https://pouet.chapril.org/@hilaire
Re: Paragraph vertical space
Doesn't work either. Le 19/11/2020 à 19:40, Gavin Smith a écrit : Try @tex \global\parskip=3em @end tex instead. -- GNU Dr. Geo http://drgeo.eu https://pouet.chapril.org/@hilaire
Paragraph vertical space
Hi, In the PDF output, I want to augment the minimum vertical space between paragraph. I tried without success this naive approach: @tex \usepackage{parskip} \setlength{\parskip}{3em} @end tex Hilaire -- GNU Dr. Geo http://drgeo.eu https://pouet.chapril.org/@hilaire
Re: Error with macro use case where arguments span in several lines
Yeah, the mail agent formatting Hope it will be right now: @c Figure with caption @macro figure{caption,file,width} @ifnotplaintext @float Figure,\file\ @center @image{\file\,\width\cm} @caption{\caption\} @end float @end ifnotplaintext @ifplaintext @float Figure @caption{\caption\} @end float @end ifplaintext @iftex @sp 1 @end iftex @end macro Le 19/11/2020 à 07:44, Gavin Smith a écrit : Ends of lines are missing here, could you send it again so I can test it? -- GNU Dr. Geo http://drgeo.eu https://pouet.chapril.org/@hilaire
Re: @value fails with @image for pdf output
You can have both pdf and png files with the same filename in the same folder. For example img1.png and img1.pdf. The pdf one will be pick up first for PDF output and png for html output. That way you just use one command for both. Hilaire Le 15/11/2020 à 19:29, Christopher Dimech a écrit : Please note that the following code fails for pdf output, but works for html if I put dirhtml at the correct relative path to index.html @set dir-pdf ../Ideogr/Ch03b--Chmed @image{@value{dir-pdf}/igc03--01--Sicl--CircAmRg.png} @set dir-html ../../Ideogr/Ch03b--Chmed @image{@value{dir-html}/igc03--01--Sicl--CircAmRgpng} -- GNU Dr. Geo http://drgeo.eu https://pouet.chapril.org/@hilaire
Background color on PDF output
Hi, In the PDF output, I would like gray background in the block environment (i.e. example, display,...) I did not find clue about this. Is it possible? Thanks Hilaire -- GNU Dr. Geo http://drgeo.eu
[help-texinfo] Sortas key
Hi, Under texinfo (6.5.0.dfsg.1-2), I noticed using @sortas twice with the same sort key is causing trouble. @cindex @sortas{e} échelle @cindex @sortas{e} équation (méthodes) Only the first occurrence appears in the index. Observed in the DrGeo programming guide: https://bazaar.launchpad.net/~drgeo-developers/drgeo/trunk/files/head:/doc/programmingGuide/ When I edit the second index to be sorted as x, the index entry appears under the x letter: @cindex @sortas{x} équation (méthodes) Did I miss something? Thanks Have a nice day. Hilaire -- GNU Dr. Geo http://drgeo.eu
Re: [help-texinfo] Referring to a Float
Responding to myself, @xref{} works with float's label. It is specified in the doc! Hilaire Le 23/03/2019 à 16:25, Hilaire Fernandes a écrit : > Hello, > > Is it possible to refer to a Float with its label? > > The expected pdf/html output will be rendered as: > > [..] > > Some code > > Example 2.5: I am an example > > [..] > > Blabla, see Example 2.5. > > > I did not find indication about that on the documentation. > > Thanks -- GNU Dr. Geo http://drgeo.eu
[help-texinfo] Referring to a Float
Hello, Is it possible to refer to a Float with its label? The expected pdf/html output will be rendered as: [..] Some code Example 2.5: I am an example [..] Blabla, see Example 2.5. I did not find indication about that on the documentation. Thanks Hilaire -- GNU Dr. Geo http://drgeo.eu
Re: [help-texinfo] @insertcopying in html
Thanks for the tips Hilaire Le 27/02/2019 à 10:42, Patrice Dumas a écrit : >> Ah, not this @insertcopying after the comment, but the one just a few >> lines bellow the @titlepage. >> >> Or is @titlepage not suited for html output? I did not read such >> limitation however. > If you want the @titlepage to be output in HTML you should set > USE_TITLEPAGE_FOR_TITLE, like > texi2any -c USE_TITLEPAGE_FOR_TITLE=1 -- GNU Dr. Geo http://drgeo.eu
[help-texinfo] @insertcopying in html
Hi, For a reason I don't understand, the @insertcopying in this attached document has no effect in html output (both makeinfo and texi2any). Any idea? Thanks Hilaire -- GNU Dr. Geo http://drgeo.eu \input texinfo @c -*-texinfo-*- @c %**start of header @settitle GNU Dr. Geo manuel utilisateur @set drgeoVersion 19.03 @setfilename drgeo.info @include ../drgeoMacro.texinfo @documentlanguage fr @documentencoding UTF-8 @c @afourlatex @smallbook @c %**end of header @copying Ce manuel est pour GNU Dr.Geo (version @value{drgeoVersion}), un environnement de géométrie interactive et de programmation. Copyright @copyright{} 2002, 2003, 2004, 2005, 2009, 2010, 2011, 2012, 2015, 2016, 2017, 2019 Hilaire Fernandes @quotation Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.3 or any later version published by the Free Software Foundation; with no Invariant Sections, with no Front-Cover Texts, and with no Back-Cover Texts. A copy of the license is included in the section entitled ``GNU Free Documentation License''. @end quotation @end copying @titlepage @title Dr. Geo, soit un géomètre @subtitle L'environnement GNU de géométrie interactive, version @value{drgeoVersion} @author Hilaire Fernandes (@email{hilaire@@drgeo.eu}) @page @vskip 0pt plus 1filll @insertcopying @* Merci aux relecteurs de ce manuel : François Audirac, Odile Benassy, Gérard Blanchet, Christophe Gragnic, Marc Leygnac, Yves Ouvrard, Thierry Pasquier, Jean Peyratout, Guy Veyssière. @end titlepage @shortcontents @contents @node Top @ifnottex @top @drgeo Guide utilisateur @drgeo (version @value{drgeoVersion}) @c @insertcopying @end ifnottex @menu * Introduction::Qu'est-ce que Dr. Geo ? * Fonctions de base:: Description des outils utilisés pour construire une figure * Fichiers et documents:: Enregistrer les documents Dr. Geo * Fonctionnalités avancées::Aller plus loin avec les fonctions avancées de Dr. Geo * Macro-construction:: Apprendre à Dr. Geo des constructions * Script Smalltalk::Insérer du code dans une figure * Figure Smalltalk::Décrire une figure par du code * Applications didactiques::Utiliser des scripts et des figures programmées pour des applications didactiques * Astuces diverses::Découvrir l'environnement de programmation * GNU Free Documentation License:: * Index:: @end menu @c== @c:INTRODUCTION @include Introduction/introduction.texinfo @c== @c:PART1 -- Getting Started @part Partie I @*Pour bien démarrer @c:Basic @include BasicFunctionalities/basic.texinfo @c:Files and Documents @include FilesAndDocuments/files.texinfo @c== @c:PART 2 -- Advanced functionalities @c:Intro @part Partie II @*Fonctionnalités avancées @include AdvancedFunctionalities/advanced.texinfo @c:Macro construction @include MacroConstruction/macro.texinfo @c:Smalltalk Script @include SmalltalkScript/SmalltalkScript.texinfo @c:Smalltalk figure @include SmalltalkFigure/SmalltalkFigure.texinfo @c== @c:PART3 -- Application @part Partie III @*Applications @c:Didactic examples @include DidacticExamples/didactics.texinfo @c:Various Tips @include VariousTips/tips.texinfo @c== @c:END OF THE BOOK @include ../fdl.texinfo @node Index @unnumbered Index conceptuel @printindex cp @unnumbered Index des méthodes @printindex fn @bye
[help-texinfo] CSS
Hi, I would like the DrGeo user manuel, when html rendered, to look a bit more modern[1], and less 90' stylish. Do we have repository of CSS to be used with the html output? It could be a good start. Thanks Hilaire [1] https://www.gnu.org/software/dr-geo/doc/en -- GNU Dr. Geo http://drgeo.eu
Re: [help-texinfo] @documentlanguage fr - ignored for html output
Le 30/10/2016 à 12:18, Patrice Dumas a écrit : > I don't remember such a bug being fixed later. A possibility could be > that the locales for in document translations are not installed at a > location makeinfo looks for. I see. Indeed the texinfo package shows TeX file for translation. Not sur about html/info output: hilaire@pchome ~/Travaux/Developpement/DrGeoII/trunk/doc/fr $ dpkg -L texinfo /. /usr /usr/bin /usr/bin/pdftexi2dvi /usr/bin/txixml2texi /usr/bin/texindex /usr/bin/texi2any /usr/bin/texi2pdf /usr/bin/texi2dvi /usr/bin/pod2texi /usr/share /usr/share/doc /usr/share/doc/texinfo /usr/share/doc/texinfo/README.gz /usr/share/doc/texinfo/TODO.gz /usr/share/doc/texinfo/txirefcard.pdf.gz /usr/share/doc/texinfo/txirefcard-a4.pdf.gz /usr/share/doc/texinfo/NEWS.gz /usr/share/doc/texinfo/README.Debian /usr/share/doc/texinfo/README.cyrtexinfo /usr/share/doc/texinfo/NEWS.Debian.gz /usr/share/doc/texinfo/copyright /usr/share/doc/texinfo/AUTHORS /usr/share/doc/texinfo/changelog.Debian.gz /usr/share/man /usr/share/man/man1 /usr/share/man/man1/texindex.1.gz /usr/share/man/man1/texi2dvi.1.gz /usr/share/man/man1/pdftexi2dvi.1.gz /usr/share/man/man1/texi2pdf.1.gz /usr/share/man/man1/texi2any.1.gz /usr/share/man/man1/makeinfo.1.gz /usr/share/man/man5 /usr/share/man/man5/texinfo.5.gz /usr/share/texmf /usr/share/texmf/tex /usr/share/texmf/tex/texinfo /usr/share/texmf/tex/texinfo/texinfo.tex /usr/share/texmf/tex/texinfo/txi-pt.tex /usr/share/texmf/tex/texinfo/txi-en.tex /usr/share/texmf/tex/texinfo/txi-es.tex /usr/share/texmf/tex/texinfo/txi-sr.tex /usr/share/texmf/tex/texinfo/txi-de.tex /usr/share/texmf/tex/texinfo/txi-nn.tex /usr/share/texmf/tex/texinfo/txi-ru.tex /usr/share/texmf/tex/texinfo/txi-fr.tex /usr/share/texmf/tex/texinfo/txi-pl.tex /usr/share/texmf/tex/texinfo/txi-uk.tex /usr/share/texmf/tex/texinfo/txi-nb.tex /usr/share/texmf/tex/texinfo/txi-cs.tex /usr/share/texmf/tex/texinfo/txi-hu.tex /usr/share/texmf/tex/texinfo/txi-tr.tex /usr/share/texmf/tex/texinfo/txi-is.tex /usr/share/texmf/tex/texinfo/txi-it.tex /usr/share/texmf/tex/texinfo/txi-nl.tex /usr/share/texinfo /usr/share/texinfo/Texinfo /usr/share/texinfo/Texinfo/Structuring.pm /usr/share/texinfo/Texinfo/Encoding.pm /usr/share/texinfo/Texinfo/Parser.pm /usr/share/texinfo/Texinfo/Common.pm /usr/share/texinfo/Texinfo/Convert /usr/share/texinfo/Texinfo/Convert/HTML.pm /usr/share/texinfo/Texinfo/Convert/TexinfoXML.pm /usr/share/texinfo/Texinfo/Convert/Text.pm /usr/share/texinfo/Texinfo/Convert/Info.pm /usr/share/texinfo/Texinfo/Convert/Unicode.pm /usr/share/texinfo/Texinfo/Convert/TexinfoSXML.pm /usr/share/texinfo/Texinfo/Convert/IXIN.pm /usr/share/texinfo/Texinfo/Convert/UnFilled.pm /usr/share/texinfo/Texinfo/Convert/Texinfo.pm /usr/share/texinfo/Texinfo/Convert/DocBook.pm /usr/share/texinfo/Texinfo/Convert/Line.pm /usr/share/texinfo/Texinfo/Convert/Plaintext.pm /usr/share/texinfo/Texinfo/Convert/PlainTexinfo.pm /usr/share/texinfo/Texinfo/Convert/Paragraph.pm /usr/share/texinfo/Texinfo/Convert/NodeNameNormalization.pm /usr/share/texinfo/Texinfo/Convert/IXINSXML.pm /usr/share/texinfo/Texinfo/Convert/Converter.pm /usr/share/texinfo/Texinfo/Convert/TextContent.pm /usr/share/texinfo/Texinfo/Documentlanguages.pm /usr/share/texinfo/Texinfo/Report.pm /usr/share/texinfo/lib /usr/share/texinfo/lib/Unicode-EastAsianWidth /usr/share/texinfo/lib/Unicode-EastAsianWidth/lib /usr/share/texinfo/lib/Unicode-EastAsianWidth/lib/Unicode /usr/share/texinfo/lib/Unicode-EastAsianWidth/lib/Unicode/EastAsianWidth.pm /usr/share/texinfo/Pod-Simple-Texinfo /usr/share/texinfo/Pod-Simple-Texinfo/Pod /usr/share/texinfo/Pod-Simple-Texinfo/Pod/Simple /usr/share/texinfo/Pod-Simple-Texinfo/Pod/Simple/Texinfo.pm /usr/share/texinfo/htmlxref.cnf /usr/share/texinfo/DebugTexinfo /usr/share/texinfo/DebugTexinfo/DebugTree.pm /usr/share/texinfo/DebugTexinfo/DebugCount.pm /usr/share/texinfo/init /usr/share/texinfo/init/chm.pm /usr/share/texinfo/init/html32.pm /usr/share/texinfo/init/latex2html.pm /usr/share/texinfo/init/book.pm /usr/share/texinfo/init/tex4ht.pm /usr/share/texinfo/texinfo.dtd /var /var/lib /var/lib/tex-common /var/lib/tex-common/fmtutil-cnf /var/lib/tex-common/fmtutil-cnf/texinfo.list /etc /etc/texmf /etc/texmf/fmt.d /etc/texmf/fmt.d/50cyrtexinfo.cnf /usr/bin/makeinfo -- Dr. Geo http://drgeo.eu
Re: [help-texinfo] @documentlanguage fr - ignored for html output
Note: built PDF get the message translated just fine, from the same .texinfo source file. Le 30/10/2016 à 12:18, Patrice Dumas a écrit : >> Hi, >> > >> > My system comes with Texinfo 5.2, I guess it is a problem related to >> > this specific version. > I don't remember such a bug being fixed later. A possibility could be > that the locales for in document translations are not installed at a > location makeinfo looks for. -- Dr. Geo http://drgeo.eu
[help-texinfo] @documentlanguage fr - ignored for html output
Hi, It looks like this command is ignored when requesting makeinfo to output html. It is working fine when generating pdf. Not sure about the .info output. Thanks Hilaire -- Dr. Geo http://drgeo.eu
Re: [help-texinfo] Path for included file
Indeed I use @image. Hilaire Le 16/10/2016 à 18:47, Gavin Smith a écrit : > I doubt there is a good way to list directories for included files > within a Texinfo file. What commands are you using to include them, is > it @image or something else? -- Dr. Geo http://drgeo.eu