(:showright:)Gemini Tips - Gemini-Talk
Flexi < Skins > Glossy Hue   (talk | users | test page | RWD? | set as default | unset | validate: HTML, CSS)

Important: This skin will not be developed further, in particular it will not be adapted to criteria. - HansB August 12, 2016, at 06:32 AM

Overview

• Gemini is a skin designed for a very high degree of customisation including easy changes for action menu and buttons and style switching, with a simple uncluttered layout, good readability and wide cross-browser support.
• You can use this skin on pmwiki.org by setting it: Set gemini skin
  And try the different style and layout options below.
  To revert to the default: Set pmwiki default skin (you'll see it when you leave this page)

Details

• The layout template is table based, with a header, a Site.SideBar which can be either left or right, a main part with a title bar keeping a left margin, a RightBar which floats right and allows the content to flow beside and beneath it, and a full-width footer.
• The RightBar is a normal wiki page displayed in a right "floating" box. It can hold small bits of news or links etc. A $Group.RightBar page will appear if it exists and there is any content in it. Otherwise the page $SiteGroup.RightBar will be used. If no content or no page exists nothing will show! It is easy to permanently disable it in skin-gemini.tmpl if it is not wanted. With the blue color scheme the right bar should have a blue background, it has in Firefox and IE6 on Windows XP.
• The RightBar can act as the main menu bar, by excluding the lefthand bar ((:noleft:)), and possibly including the Site.SideBar ((:include Site.SideBar:) in page RightBar ).
• With version 9 an individual RightBar can be assigned to each page, by creating a page with the name Group.Pagename-RightBar, i.e. "-RightBar" is appended to the page name to form a new page.
• Page actions in the top left corner and the footer are defined through wiki pages called Site.PageTopMenu and Site.PageFootMenu. This enables easy configuration of action buttons and other desired links. It is also an easy way to hide certain action links. One can have also custom pages for the action-links in different groups, just create a PageFootMenu and/or PageTopMenu page in any group. They will automatically have preference. The top right action bar can be disabled on any page or group also through a (:notopmenu:) directive. (:nofootmenu:) will hide the actions at the bottom, or (:noaction:) will disable both.
• Site.PageFooter may contain footer information, displayed across the bottom of the page, like copyright info etc.
• The $SiteGroup variable specifies the group which holds site-wide configuration pages, its future default value will be a group named "Site". I have been using "PmWikiAdmin" so far for this, but have changed over to "Site" as this will be the new PmWiki default standard. I apologise if this is giving difficulties to admins upgrading the skin.
• Style switching is made possible through a modular structure and the inclusion of various css files for different fonts and color schemes. The preferred scheme for a user is remembered via a cookie setting. To change the default see Gemini Tips. Try out different schemes from the list in the right bar.
• A (:theme colorname fontname:) markup has been added, which gives the possibility to display individual pages, or groups, with their own colour and font schemes via markup. See Test.GeminiThemes
• Site.Gemini-EditForm provides a skin-customised edit form, which is maximised for easier work, also the title displayed acts as a link back to the page view, since the normal title has been excluded. Same modifications are done to the history window and the uploads window via code in the skin.php file. The uploads form has been changed too to give a long input box for the file selection, since I never could read the name of the file to be uploaded in the default box.
• New: Site.Popup-EditForm as default edit form: As Gemini-EditForm, but with additional popup preview and help panes. No more scrolling down to see the preview. This uses ShowHide buttons with javascript. For browsers not supporting javascript the edit window behaves as normal.
• The SideBar supports the use of second level list elements, which are indented from the first level. See Expanding Menus for details how this can be used and see the sidebar there as demonstration. Pmwiki.org's sidebar causes a few problems since it uses in some places two links on the same line. Gemini always puts each link on a seperate line, and puts any text after a link on a separate line as well. So it is good to write your sidebar menu accordingly.
• New: Built-in fontsizer for easy text sizing, preferences are saved via cookie setting. The fontsizer buttons are by default displayed on the sidebar, but can be disabled and located anywhere with markup (:fontsizer:). If a browser does not support javascript the buttons will not be shown and this function will not be available.
• You can visit the demo on my site. enjoy!
• This skin is valid XHTML 1.0 Transitional and valid css.

Browser Compatibility

This is an incomplete listing of the browsers which have been seen working with this skin.

Windows:

• Works with Google Chrome, Firefox 1-3, IE5-7, Netscape 7, Opera 7-9

Mac:

• Works with Safari, Firefox 1, Netscape 6, IE5.1 Mac classic, IE5.2 OSX.
  The Rightbar in IE for Mac does not allow the text to flow around the box.

Linux:

• Works with Firefox 1-2, Konqueror

Comments see Gemini-Talk

Installation

• Download: gemini.zipΔ

There is a detailed installation text included.
Install in the usual way by unzipping into skin directory.
A directory named gemini will be created with all the files.
Upload this and add to config.php:
$Skin = 'gemini';

Update history

• 2023-02-24: Fixed for PHP 8.1 compatibility.
• 2017-06-20: Fixed markup definitions for PHP 7.2 compatibility, fixed some minor bugs.
• 2014-02-20: Fixed markup definitions for PHP 5.5 compatibility (PmWiki 2.2.56 or above required).
• 2010-05-08: Undone last update. Changed css for preformatted text wrapping; added $EnablePreWrap, so $EnablePreWrap = 0; can disable preformattedf text wrap.
• 2010-04-20: updated pmwiki-core.css (now wrapping pre and code)
• 2010-04-02: updated pmwiki-core.css; fixed html tag; fixed links in edit help page.
• 2008-07-10: Various changes to make skin doctype XHTML1-strict compliant.
• 2007-12-02: Improved background image settings. Added $BackgroundImgUrlFmt.
• 2007-11-23: Added transparent colour scheme. Added option to (:theme:) markup to set background image for transparent colour scheme.
• 2007-11-21: Fixed misalignment of horizontal rules beside rfame & lframe boxes.
• 2007-10-22: Updated all color css files with new message (comment) box definitions, for Fox and FoxForum etc support.
• 2007-03-05: Fixed (:theme :) markup, broken since introducing new css load order (2006-11-03).
• 2007-02-17: Fixed bug in page header displaying two logo images by default. PageHeader is now always used.
• 2007-01-27: Fixed ordered list styling when part of an unordered list. Changed {$LastModified} in PageFootMenu to {*$LastModified} for pmwiki beta 2.2.0 compliance. Removed spurious hidden field from searchbox.
• 2006-12-07: More improvements of Popup-EditForm and the way it is called.
• 2006-12-06: Fixed small bug in conditional in Site.Popup-EditForm. Removed #content .inputbox {width:..}.
• 2006-11-25: Added global variables $HTMLTitleFmt, $GroupTitleFmt, $TitleFmt. Fixed bug in searchbox, which prevented IE to clear searchbox when focussed. Removed show/hide preview button with no label in Popup-EditForm.
• 2006-11-20: Added support for GroupTitle recipe, to display GroupTitle as link in titlebar.
• 2006-11-11: Added option to have sidebar on the right. Added variable to change sidebar width. Added variables to switch off user options individually for the different types of options (colors, fonts, rightbar-width, sidebar position, header layout) to give more admin control via config.php or other local configuration files. Changed folder structure.
• 2006-11-03: New improved load order for css files. Support for pmwiki-core.css file. Reduced code in page head. Fixed bug in fontsizer script which did not display fontsizer buttons on first site visit, but only on subsequent page loads.
• 2006-10-28: Added $RecipeInfo
• 2006-10-05: Changed edit (and other) links to work with relative urls in PmWiki 2.2.0-betas, added backward compatibility for {*$Var} with prior versions
• 2006-09-02: Added SideBarFooter page to replace skin version info. Added page variables SkinName, SkinVersionDate, SkinVersionNum, SkinVersion (SkinName and SkinDate), SkinRecipeName, SkinSourceUrl. Added access keys to fontsizer.
• 2006-08-31: Some template changes regards to javascript employed for sizing width and sidebar height. Removed aux-gemini.js from gemini/ directory.
• 2006-08-28: Template now uses HTMLHeader and HTMLFooter, also added var $BodyAttrFmt to <body> tag.
• 2006-08-21: Improved cookie settings.
• 2006-08-19: Added support for .lnav and .rnav div classes for top menu (left and right floating like Triad skin). Fixed bug so showhide will not load if alrady loaded from cookbook.
• 2006-06-25: Fixed bug in layout-print.css to hide sidebar when printing etc.
• 2006-05-03: Added savedraft button to edit form.
• 2006-04-28: Removed onkeypress event from fontsizer.js, which interfered with tab navigation.
• 2006-04-20: Minor changes: Fixed links and page GeminiSkin.
• 2006-04-13: Changed layout css to fix bug in Netscape 7 which broke layout with fontsizer.
• 2006-04-10 (v. 12): Changed skin template and layout css files to display top menu as floating div instead of absolutely positioned div. This cures an issue with the font sizer and Firefox, where the topmenu was not aligned properly when the font size was changed. - This change may have an effect on sites with a very wide logo (in standard layout), as the top menu will now no longer overlay the logo. In such a case I advice to load the logo as a background image in the header division.
• 2006-04-09 (v.11.7): Fixed body font size for verdana font css.
• 2006-04-08 (v.11.6): Changed custom searchbox to accept optional target= parameter for displaying search results on a specific target=GroupName.PageName page.
• 2006-04-07 (v.11.5): Fixed a few development left-overs. Changed link on Site.Gemini-Configuration page from Site.Gemini-EditForm to Site.Popup-EditForm.
• 2006-03-27 (v.11.4): Updated README text file.
• 2006-03-24 (v.11.3): Fixed bug in upload form alignment, change to upload form spacings. Fixed bug in pagetop menu which jerked the menu to the right a little when clicking on an item.
• 2006-03-22 (v.11): Major new release for pmwiki 2.1. Updated searchbox. Added new full-width edit window with popup preview and help panes, using ShowHide and Popup EditForm. Added font-sizer buttons for easy text sizing. Added color support for full CommentBoxPlus integration. Updated font styling, especially vertical header spacings. Updated cookie setting to make it fully skin-specific. Added horizontal double rule markup ====. Added support for (:noaction:), which combines (:notopmenu:) and (:nofootmenu:).
• 2005-11-13 (v.10b): Fixed bug which froze IE6 when opening pages with colour schemes red-gold, green-gold, pink, parchment-blue and parchment-yellow.
• 2005-10-24 (v.10a): Adjusted internationalisations in config files. Corrected some colour problems in reverse colour schemes (night and stars).
• 2005-09-05 (v.10.03): Small Firefox bug fix for pixel correct styling: changed line-height in font css files to use % rather than em units.
• 2005-09-03 (v.10.02): Adjusted rightbar header sizes. Adjusted group title display.
• 2005-09-02 (v.10.0): Added Georgia font scheme for a better readable serif font. Added support for %sidehead% SideBar headings. Small revision of spacings and font colours in the sidebar. Added support pages GeminiTips and an "About" page linked from the sidebar footer. Revised Gemini-EditForm to use styling of buttons.
• 2005-08-19 (v.9m): Removed some empty spaces in SearchboxFmt code, which lead to <p> or <pre> tags around the searchbox html code.
• 2005-08-18 (v.9l): Bug fix in searchbox, which crept into v9i.
• 2005-08-18 (v.9k): Added style support for newpagebox2.php. Revised heading styling. Changed title to use <h1> tags. Fixed bug which prevented individual righbars to show if no general rightbar was present.
• 2005-08-16 (v.9i): Corrected bug with sidebar searchbox. Mended link in Site.Gemini-EditForm. Improved silver scheme.
• 2005-08-15 (v.9h): Added style support for all header sizes in sidebar. Adjusted some font sizes and title layout. Updated color css files (missed some in last update).
• 2005-08-09 (v.9g): Added (:theme:) markup. Added 'silver' colour scheme. Added automatic installation of skin config pages. Updated all color and font css files. Rightbar background & border styling now inside each color css file.
• 2005-07-16 (v.9f): Removed PageEditFmt definition, edit form can now be changed by editing Site.EditForm. Sample Editform included with the skin. Removed altforms.php and moved some of its code to skin.php.
• 2005-07-13 (v.9e): Further adjustments to pmwiki 2 beta 44 release. Site.Search is now supported instead of Main.SearchWiki. Update to documentation. Support for a Pagename-TitleBar page added, which will display instead of the standard title, for displaying titles in form of images of special fonts.
• 2005-07-10 (v.9d): Adjustments to pmwiki 2 beta 44 release.
• 2005-07-05 (v.9c): Small correction in template, improved README and wiki.d support pages.
• 2005-06-29 (v.9b): Added stylesheet for print support, pages can now be printed directly without needing first to open Print View.
• 2005-06-25 (v.9a): Updated README and set up skin to use default 'Site' group for admin pages (from previous PmWikiAdmin). Fixed bug which prevented Rightbar background to show at times when used first time. Fixed bug which showed PageHeader content as well as logo specified with $PageLogoUrl.
• 2005-06-23 (v.9): Added support for unique RightBar pages for individual pages of the form Pagename-RightBar. Introduced $SiteGroup as variable for the admin group in the template.
• 2005-06-15 (v.8d): Changed css code for links in PageFootMenu. Links can be now either list items, which will display as buttons, or simple links, which will display inline as underlined links (good for creating a discret edit link without the highly visible buttons).
• 2005-05-15 (v.8c): Restored logo display via $PageLogoUrl definition in config.php. Logo thus defined will display, unless a PageHeader page exists (in PmWikiAdmin, Main or the current group).
• 2005-05-09 (v.8b): Fixed bug which stretched the sidebar in IE6 vertically when content page got very long.
• 2005-05-07 (v.8a): A change in the way the defaults are declared in skin.php. It is now possible to set new defaults in config.php (or a group's GroupName.php file for instance to set different colours to different groups)
• 2005-05-05 (v.8): This is a major upgrade and requires some reconfigurations. Brief summery:
  • Added inclusion of PmwikiAdmin.PageHeader for configuration of logo or wiki title text. This replaces the logo inclusion via config.php and skin-template markup.
  • The other configuration pages (PageTopMenu, PageFootMenu, PageFooter) can be placed also in the new PmWikiAdmin group.
  • Added nine more colour schemes, some with textured backgrounds.
  • Some parts of the template, skin.php and css code redesigned.
  • Sidebar redesign with better line support.
  • Sidebar searchbox can be disabled, or added at different locations.
  • Group name in titlebar can be disabled for all pages with switch in skin.php, or disabled on individual pages or groups with custom markup (:nogroup:).
  • skin.php rewritten for easier setting of options, and more commentaries added.
  • Many files renamed and image folder added.- It is best to update to this version by deleting previous files, or renaming previous skin directory first.
• 2005-03-07 (v.7): This update requires some reconfigurations/renaming of the action menu pages. I hope the new names are more logical, and the added true pagefooter is useful: Changed PageAction to PageTopMenu, changed PageFooter to PageFootMenu, added PageFooter as window-wide footer for copyright notices etc. Moved "Page last modified ..." from template into PageFootMenu for better customisation. Removed footmenu from edit page. Added second save button to edit page underneath edit area. Adjusted sidebar font sizes. Included a configuration option in skin.php to hide the rightbar by default and show it only using special markup (:showright:) for pages or groups which need a rightbar.
• 2005-02-17 (v.6): This is an update to the colour (color) css modules, lightening the content backgrounds, and some small changes to borders and buttons.
  I fixes a bug which prevented showing the rightbar background and border when the color was not set, and a bug which prevented menu items in the sidebar using the whole width of it.
• 2005-01-15 (v.5): I rewrote lots of css code to make the skin more cross-browser compatible and stable.
  The order of the links appearing in the top right action menu are reversed, meaning they will appear in the order of the list.
  The edit form has been fixed so that it will not stretch in IE6 when text gets entered.

Contributors

• ~HansB