This issue has been created
 
 
XWiki Platform / cid:jira-generated-image-avatar-c86453d5-03a0-4254-ba03-48a89aed6176 XWIKI-25804 Open

The XWiki Syntax help page reuses the Administration layout instead of defining its own

 
View issue   ยท   Add comment
 

Issue created

 
cid:jira-generated-image-avatar-1cff4379-5411-4e01-b212-3e0ba901a5b1 Charpentier Lucas created this issue on 19/Nov/26 15:05
 
Summary: The XWiki Syntax help page reuses the Administration layout instead of defining its own
Issue Type: cid:jira-generated-image-avatar-c86453d5-03a0-4254-ba03-48a89aed6176 Improvement
Affects Versions: 18.9.0
Assignee: Unassigned
Components: Flamingo Skin, Help
Created: 19/Nov/26 15:05
Priority: cid:jira-generated-image-static-minor-de49e806-9f65-498e-a7bc-13bc6cffcb6b Minor
Reporter: Charpentier Lucas
Description:

The XWiki Syntax help page (XWiki.XWikiSyntax) has no layout of its own: since XWIKI-10675, the Flamingo skin gives its menu and content the layout of the Administration pages, by applying the .admin-menu and #admin-page-content rules to .syntax-menu and #syntax-page-content. The page also still ships a margin-left: 15em rule from the Colibri era, which the skin has to cancel.

This keeps page-specific styles in the skin, and any change to the Administration layout silently changes the syntax help page too.

Proposal

  • Lay out the page with the Bootstrap grid classes in XWikiSyntax.xml: a row wrapper, col-xs-12 col-sm-3 on the menu and col-xs-12 col-sm-9 on the content.
  • Remove the obsolete margin-left: 15em rule from the page's style sheet extension.
  • Remove the syntax help selectors from the skin's admin.css.

Expected visual changes

  • On screens of 1200px and wider, the menu is no longer capped at 300px.
  • The row wrapper adds -15px side margins, and the columns keep their gutter padding below 480px.

These need to be reviewed, and adjusted if unwanted.

Note

This was first part of the conversion of admin.less to CSS in XWIKI-23674, then split out to keep that conversion free of visual changes.