OmegaT - multiplatform CAT tool / Documentation / #431 Moving to docbook 5

Jean-Christophe Helary - 2025-02-13

Related branches:
https://github.com/omegat-org/omegat/tree/topic/jc/doc/directLinksToItems

If you would like to refer to this comment somewhere else in this project, copy and paste the following link:

Jean-Christophe Helary - 2025-03-08

@miurahr9

https://github.com/omegat-org/omegat/tree/topic/jc/doc/docbook5

We can start to work on this.

If you would like to refer to this comment somewhere else in this project, copy and paste the following link:

Hiroshi Miura - 2025-03-10

I think it is better to incubate it in the sandbox project branch https://github.com/omegat-org/omegat-manual/

👍
1

Last edit: Hiroshi Miura 2025-05-24

If you would like to refer to this comment somewhere else in this project, copy and paste the following link:
- Hiroshi Miura - 2025-05-24
  
  Now the main branch of the sandbox project build successfully docbook5 source.
  There is only two files are written in DocBook 5.
  Rest of the files are kept in docbook 4 for your task. @brandelune
  
  Please look at the docbook5 sample file at
  https://github.com/omegat-org/omegat-manual/blob/main/src_docs/manual/en/sample.xml
  
  🎉
  1
  
  If you would like to refer to this comment somewhere else in this project, copy and paste the following link:
  - Jean-Christophe Helary - 2025-05-24
    
    Thank you very much Hiroshi.
    
    If you would like to refer to this comment somewhere else in this project, copy and paste the following link:
    - Hiroshi Miura - 2025-05-25
      
      I found db4-upgrade.xsl migration tool and it convert all the manuals into docbook 5 style format.
      
      There are still several issues such as
      - Top page design is not good
      - Dynamic search box will be open by clicking right-top book icon, but it is difficult to find.
      
      If you would like to refer to this comment somewhere else in this project, copy and paste the following link:
      - Hiroshi Miura - 2025-05-25
        
        Here is a capture of the db5 manual with dynamic ToC search.
        
        db5-manual-screen-2025-05-25 10-45-17.png
        
        If you would like to refer to this comment somewhere else in this project, copy and paste the following link:
        
        Jean-Christophe Helary - 2025-05-25
        
        Indeed. It’s not using the docbook whc stylesheet that we used for the conversion to HTML so everything it broken.
        
        Until we find a better stylesheet it would be nice to continue using the whc system.
        
        If you would like to refer to this comment somewhere else in this project, copy and paste the following link:
        
        Hiroshi Miura - 2025-05-25
        
        Thank you for the feedback.
        
        I haven’t included WHC in this step because I believe the migration should proceed incrementally. Trying to move everything at once would make it harder to isolate and debug issues.
        
        At this point, the DocBook XSLT conversion completes successfully. We can now move forward and start investigating the CSS-related problems.
        
        If you would like to refer to this comment somewhere else in this project, copy and paste the following link:
        
        Hiroshi Miura - 2025-05-26
        
        The sandbox project has now started using the WHC system.
        We need to update the XSLT stylesheets because the generated HTML/XML differs from DocBook 4 .
        
        If you would like to refer to this comment somewhere else in this project, copy and paste the following link:
        
        Jean-Christophe Helary - 2025-05-26
        
        Ok. It’s going to take some time before I can check all that. Thank you for your help so far.
        
        If you would like to refer to this comment somewhere else in this project, copy and paste the following link:

Moving to docbook 5

The free computer aided translation (CAT) tool for professionals

Group

Searches

Help

#431 Moving to docbook 5

Discussion