[All Adaptavist Apps]

Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Wiki Markup
{scrollbar:no-css=true}
h1. Creating CSS Files

*{excerpt}Move your style sheet in to a CSS file for improved performance...{excerpt}*

h2. Why create CSS files?

While it may be convinent to edit your stylesheets within the configuration screen, you should consider using a CSS file instead for the following reasons:

* The CSS file can be edited in a wider range of software - anything from Windows Notepad to Macromedia Dreamweaver
* The CSS file is easy to back-up - especially if it's attached to your home page as an attachment (in which case it is automatically backed up)
* If you want multiple spaces to look the same, you can easily link to the same stylesheet

h2. Creating and linking to the CSS file

Creating a CSS file is easy - simply create a new text document, paste in your style sheets and save it with a ??.css?? extension. Make sure you save the file as plain text though - some word processors compress files or add other information which would confuse the web browser.

Once you've created the CSS file, upload it as an [attachment] to your space home page{footnote}When uploading a CSS file as an attachment, it's usually best to store it on a publicly available home page so that all spaces will be able to link to it.{footnote} and then right-click the attachment to display the pop-up contextual menu:

!getting_attachment_location.gif|align=center!

Depending on which browser you are using, you'll see an option like ??Copy Link Location?? or ??Copy Shortcut??, etc. Select that link to copy the URL of the attachment to the clipboard.

Next, enter [Theme Configuration 1.6.x] and set focus to the ??CSS Custom Styles?? text box. If the old copy of your style sheet is stil in there, delete it and then paste{footnote}To paste text from the clipboard, use either "Ctrl"\+"V" (or "Option"\+"V" on OS X) or right-click the text box and choose the ??Paste?? option.{footnote} in the URL to the new CSS file.

{display-footnotes}

Now, add the following text to the start of the URL:

{noformat}@import url({noformat}

And the following text to the end of the URL:

{noformat});{noformat}

The end result will look something like this:

{noformat}@import url(http://www.adaptavist.com/download/attachments/918/adaptavist.css);{noformat}

The URL will obviously be specific to your server address and the location where you stored the attachment.

If you want to use the same stylesheet in other spaces, simply enter the same text in to the ??CSS Custom Styles?? text box for those spaces.

If you need to make changes to your style sheets, simply attach a new version{footnote}Depending on your web browser settings, you might need to refresh the page or clear you cache for the changes to take effect.{footnote} of the same file to the same location.

Should you need any space-specific styles, those can be added below the ??@import...?? line - this allows you to create a general, reusable stylesheet that does the bulk of the cusotmisation for several spaces and then add space-specific styles within each space.

{display-footnotes}