2024-11-04 Kjell Ahlstedt 4.12.0 2024-10-28 Kjell Ahlstedt Makefile.am: Distribute new docs/tutorial/ files Distribute book.xsl, highlight.js/highlight.min.css and highlight.js/highlight.min.js. These files are used only when building with meson. 2024-10-27 sid docbook: Remove newline after which displays empty space on top of code snippets There were 130 instances. Replaced with emacs macros. 2024-10-27 sid Fix the following hint messages while building pdf code: default template used in programlisting or screen function: default template used in programlisting or screen 2024-10-27 sid Remove '\n' which displays empty space on top of example code Some code snippets (not included example files) still start on a new line in docbook. This is addressed in a subsequent commit. 2024-10-25 sid docbook: Fix RELAX NG error (identified with jing) 'xmllint' is pretty useless at reporting RELAX-NG errors, as it gives unrelated error hints and line numbers as below: docs/tutorial/index.docbook:10426: element para: Relax-NG validity error : Did not expect element para there docs/tutorial/index.docbook:10433: element section: Relax-NG validity error : Did not expect element section there docs/tutorial/index.docbook:10433: element section: Relax-NG validity error : Element chapter has extra content: section docs/tutorial/index.docbook:44: element info: Relax-NG validity error : Element book has extra content: info docs/tutorial/index.docbook fails to validate Refer https://github.com/NixOS/nixpkgs/issues/4966 for more details. With 'jing', the error was correctly identified as invalid use of >kmm; within tag. $ jing https://docbook.org/xml/5.0/rng/docbook.rng docs/tutorial/index.docbook index.docbook:10504:40: error: element "application" not allowed here; expected the element end-tag, text or element "alt", "anchor", "annotation" ... 2024-10-25 sid docbook: Add tag after 
 so highlight.js works for code snippets

  E.g:
  
  
    
      actual code
    
  

  
  The 
 tags will be generated when  is converted to HTML.
  
  Actual changes:
  
  - Substitute  with 
  - Substitute  with 

2024-10-25  sid  

  Add  tag after 
 so highlight.js works for example code from files

  E.g:
  
  
    
      actual code
    
  

  
  The 
 tags will be generated when  is converted to HTML.

2024-10-25  sid  

  Add highlight.js support for all generated HTML files

  This commit adds the following code in the '' tag of all
  generated HTML files, as shown below:
  
  --- a/chapter-basics.html
  +++ b/chapter-basics.html
  @@ -1,5 +1,12 @@
   
   
   
  +  
  +  
  +  
   Chapter 3. Basics
   

2024-10-25  sid  

  Improve code visual parameters so it's not too small and crowded.

2024-10-25  sid  

  Add support for code syntax highlighting through highlight.js

  Adds highlight.js v11.9.0.
  
  I've evaluated the following 3 C++ highlighting CSS styles:
  
  - default.min.css (default C++ style provided by highlight.js)
  - intellij-light.min.css (intellij C++ style)
  - stackoverflow-light.min.css (stackoverflow C++ style)
  
  After a few tries in various pages, I settled upon intellij style, as
  it looked good and wasn't distracting (as with stackoverflow style
  sometimes with too much orange), and not too passive colors (as with
  default.min.css).
  
  So, the current 'highlight.min.css' is actually 'intellij-light.min.css'.
  
  Please feel free to modify in needed.

2024-08-23  Kjell Ahlstedt  

  Add example and description of mouse events

  * docs/tutorial/C/index-in.docbook: Add Mouse Events section.
  * Rename docs/tutorial/C/figures/keyboardevents_simple.png -> events_simple.png
  * Rename docs/tutorial/C/figures/keyboardevents_propagation.png -> events_propagation.png
  * docs/tutorial/C/figures/events_mouse.png: New file.
  * docs/tutorial/Makefile.am:
  * docs/tutorial/meson.build:
  * examples/Makefile.am:
  * examples/book/meson.build: Rename and add files and directories.
  * Rename examples/book/keyboard_events -> events
  * Rename examples/book/events/simple -> keyboard_simple
  * Rename examples/book/events/propagation -> keyboard_propagation
  * examples/book/events/mouse/*: New example.
  
  Part of the new example program has been provided by Petr Talla.
  Fixes #23

2024-07-04  Kjell Ahlstedt  

  Don't refer to developer.gnome.org

  Require python3 >= 3.7. That's what Meson requires.

2024-05-31  Kjell Ahlstedt  

  Remove link to developer-old.gnome.org

  The glib-compile-resources command is not described there nowadays.
  Fixes #21

2024-05-26  Kjell Ahlstedt  

  CI: Don't allow the validation to fail

2024-05-26  Kjell Ahlstedt  

  Avoid  elements within  elements

  In some situations the translation tools (itstool and friends)
  can't create translated index.docbook files if a  element
  occurs in a  element. See !11
  
  A  in a  can behave differently depending on which
  version of libxml2 is used. (itstool calls functions in libxml2.)
  Don't put any  in a .

2024-05-22  Kjell Ahlstedt  

  CI: Allow the validation to fail

  Allow the validation to fail until we have been able to figure out what's
  wrong with the Chinese translation. It does not fail in Ubuntu 24.04.
  Probably depends on which version of itstool is used.

2024-05-22  Kjell Ahlstedt  

  Examples: Use Gtk::SearchEntry2 if gtkmm-4.0 >= 4.13.2

  Affects examples book/buildapp/step6, step7, step8, step9 and book/searchbar.

2024-05-20  Dawid Chemloul  

  Connected on_unbind_list_item to factory signal_unbind