[Libreoffice-commits] core.git: helpcontent2

Olivier Hallot olivier.hallot at libreoffice.org
Tue May 30 14:12:52 UTC 2017


 helpcontent2 |    2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

New commits:
commit ff810509839be584ec0c351a620c61bf32d055f2
Author: Olivier Hallot <olivier.hallot at libreoffice.org>
Date:   Tue May 30 10:19:56 2017 -0300

    Updated core
    Project: help  72e210bd694688738bffb6855221e2b1ff0b1e72
    
    Rewrite online help contents
    
    I have worked in a new implementation of the Help online. The strategy
    was to batch "flatten" all XHP into HTML files with an offline
    transformation using xsltproc.
    
    (by "flatten", I mean resolve all embeds in XHP files)
    
    see http://vm173.documentfoundation.org
    
    This way all displayed files are now HTML with minimal javascript. No
    more on-line XSLT transformation and their associate issues (delays) and
    poor debug.
    
    Advantages:
    1) preserve all XHP files as-is, authoring tools, DTD.
    2) preserve current translation workflow
    3) all files turned to HTML static, with minimum Javascript
    4) much faster load times, browser cache  used.
    5) Honors parameters &System and &DbPAR
    6) URL bookmarking in browser (Ctrl-D)
    7) Page navigation back and forth with browser buttons
    8) preserve current HC2 in LibreOffice (see 1).
    9) resolved <switchinline><caseinline> for &System and &DbPAR (aka
    module).
    10) maintained Fabio's bookmark search solution.
    11) index-able by search engines (XHP files were unknown to robots).
    12) pages can be directly accessed: e.g.
    http://localhost/text/scalc/01/04060106.html?DbPAR=CALC#bm_id3153114
    13) hold Google search snippet in TopRight area
    
    Disadvantages (Most are further work):
    1) issue with offline use (file://path/to/pages/)
    
    To do:
    1) batch create html of localized pages, localized bookmarks
    2) Resolve missing images paths (Icons are in core/icon-themes/)
    3) Resolve protocol file:// for offline use (hit CORS guideline
    restriction for browsers)
    4) provide better layout for bookmarks in the left pane
    5) work on web CSS to make it beautiful
    6) Clean up the XSLT filter, set a debug param.
    7) more
    
    Change-Id: I6de74037dbb59da872153f853237afd75b47c917
    Reviewed-on: https://gerrit.libreoffice.org/38220
    Reviewed-by: Olivier Hallot <olivier.hallot at edx.srv.br>
    Tested-by: Olivier Hallot <olivier.hallot at edx.srv.br>

diff --git a/helpcontent2 b/helpcontent2
index 6e54fc4fe1c0..72e210bd6946 160000
--- a/helpcontent2
+++ b/helpcontent2
@@ -1 +1 @@
-Subproject commit 6e54fc4fe1c01d4b3b015b9074f0dc8d10257ee9
+Subproject commit 72e210bd694688738bffb6855221e2b1ff0b1e72


More information about the Libreoffice-commits mailing list