css1Add my vote for this tag rendering1Add my vote for this tag create new tag
, view all tags

Style Plugin

A TWiki notation for adding css style class references with span and div tags


Why is this useful? Well, there are times when you want a consistent look and feel for certain types of items. For example, if you have a list or table, you might want certain fields to have a certain appearance. At DaleBookList we have a list of books and authors, with some publishers. Here's what a typical entry looks like:

  • ((booktitle)(Programming Ruby)) by ((author)(Andrew Hunt and David Thomas)), ((publisher)(Addison-Wesley)), 2001

If the plugin is installed, and you have defined the style classes for 'booktitle', 'author', and 'publisher', the list item looks good. If you have the plugin installed, but don't have the style classes defined, then the list item looks, well, normal. If you don't have the plugin installed then you see all the parentheses and style names.

More generally, the style plugin lets you get away from the "let's make this bold and that italic" kind of formatting. Instead you can focus on semantic labelling of content and let the css stylesheet take care of the presentation.

Syntax Rules

A style class applied to a div tag

Use "\n---[.yourstylename ... \n---]"

This will produce

<div class=yourstylename> ... </div>

A style class applied to a span tag

Use "((yourstylename)(a chunk o' text))

This will produce

<span class=yourstylename> a chunk o' text</span>

A style class applied to a paragraph

Use ".yourstylename\nyour text"

This will produce

<p class=yourstylename> your text 

A blockquote

Use '\n---"( your quoted material \n---")

This will produce

<blockquote>your quoted material</blockquote>


For example:

((acronym)(CSS)(Cascading Style Sheet))

This will produce

<acronym title="Cascading Style Sheet">CSS</acronym>

StylePlugin Settings

Plugin settings are stored as preferences variables. To reference a plugin setting write %<plugin>_<setting>%, i.e. %STYLEPLUGIN_SHORTDESCRIPTION%

  • One line description, is shown in the TextFormattingRules topic:
    • Set SHORTDESCRIPTION = A TWiki notation for adding css style class references with span and div tags

  • Debug plugin: (See output in data/debug.txt)
    • Set DEBUG = 0

  • Disable styles for non-rendering skins
    • Set SKIPSKIN = rss, cdf

  • site styles
    • Set SITESTYLES = .minilink { font-size:smaller; } .webref { font-size:larger; font-weight:bold; } .author, .BAuthor {font-weight:bold; font-style:normal;} .booktitle, .BTitle {font-style:italic; font-weight:normal; text-decoration:underline;} .publisher, .BPublisher { font-style:italic; } .note {color:green; font-style:italic; } .note:before {display:inline; content: "Note: "; } .new {font-weight:bold; color:red; } .deprecated {text-decoration:line-through; color:gray; } .comment {font-style:italic; background-color: #CCFFCC; } .ebook {width:6in; text-align:justify;} .super {vertical-align:super; font-size:smaller;} .sub {vertical-align:sub; font-size:smaller;} .article { padding-left:10px;padding-right:10px; width:6in; text-align:justify; } .pullquote { border-left:1px;border-right:1px;border-color:black;border-style:solid; border-top:0px;border-bottom:0px; padding-left:10px;padding-right:10px; margin-left:10px; font-style:italic; } .sidebar { background-color:#eee; border-width:2px; border-color:black;border-style:solid; padding:3px; padding-right:5px; position:relative;float:right; width:230px; font-size:smaller;} .question {font-weight:bold; } .answer {font-style:italic; } abbr, acronym, .help { border-bottom: 1px dotted #333; cursor: help; } DT {font-weight:bold;text-decoration:underline;margin-left:10px; } .intro {font-weight:bold;font-style:italic;margin-left:30px;} .hide {position:absolute; width:1px;visibility:hidden; height:1px;}
    • Unused: TH {text-align: center; font-weight: bold; background-color:#eeeeee; vertical-align: top; } TD {vertical-align: top; } TABLE { border-width: 1; }

Plugin Installation Instructions

Note: You do not need to install anything on the browser to use this plugin. The following instructions are for the administrator who installs the plugin on the server where TWiki is running.

  • Run configure for automated install, or do manual install:
  • Download the ZIP file from the Plugin web (see below)
  • Unzip StylePlugin.zip in your twiki installation directory. Content:
    File: Description:
    data/TWiki/StylePlugin.txt NEW
    lib/TWiki/Plugins/StylePlugin.pm NEW

  • Visit configure in your TWiki installation, and enable the plugin in the {Plugins} section.

Plugin Info

Plugin Author: TWiki:Main.DaleBrayden
Copyright: © 2002-2003 TWiki:Main.DaleBrayden
© 2007-2011 TWiki:TWiki.TWikiContributor
License: GPL (GNU General Public License)
Plugin Version: 2011-01-12
Change History:  
2011-01-12: TWikibug:Item6530: Doc improvements; changing TWIKIWEB to SYSTEMWEB -- TWiki:Main.PeterThoeny
2003-03-09: Added SITESTYLES variable
2002-12-26: Initial version
CPAN Dependencies: none
Other Dependencies: none
Perl Version: 5.0
Plugin Home: http://TWiki.org/cgi-bin/view/Plugins/StylePlugin
Feedback: http://TWiki.org/cgi-bin/view/Plugins/StylePluginDev

Related Topics: TWikiPreferences, TWikiPlugins

Topic attachments
I Attachment History Action Size Date Who Comment
Unknown file formatmd5 StylePlugin.md5 r4 r3 r2 r1 manage 0.2 K 2011-01-13 - 07:57 PeterThoeny  
Compressed Zip archivetgz StylePlugin.tgz r4 r3 r2 r1 manage 5.5 K 2011-01-13 - 07:57 PeterThoeny  
Compressed Zip archivezip StylePlugin.zip r5 r4 r3 r2 r1 manage 6.9 K 2011-01-13 - 07:57 PeterThoeny  
Unknown file formatEXT StylePlugin_installer r3 r2 r1 manage 3.4 K 2011-01-13 - 07:57 PeterThoeny  
Edit | Attach | Watch | Print version | History: r18 < r17 < r16 < r15 < r14 | Backlinks | Raw View | Raw edit | More topic actions
Topic revision: r18 - 2013-10-16 - PeterThoeny
  • Learn about TWiki  
  • Download TWiki
This site is powered by the TWiki collaboration platform Powered by Perl Hosted by OICcam.com Ideas, requests, problems regarding TWiki? Send feedback. Ask community in the support forum.
Copyright © 1999-2018 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.