ThemesAnatomy: Difference between revisions

From SoylentNews
Jump to navigation Jump to search
(Created page with " <h2>Notes</h2> There are currently three themes in slash/themes: <pre> slashcode slashcode.com useperl </pre> <h2>Official docs for themes from docs/HOWTO-Themes.pod</...")
 
No edit summary
Line 4: Line 4:
There are currently three themes in slash/themes:
There are currently three themes in slash/themes:
<pre>
<pre>
slashcode
slashcode - seems to be primary theme used.
slashcode.com
slashcode.com   - the slashcode.css used seems to be here. Also ostnavbar.css see below.
useperl
useperl
</pre>
</pre>
Apparently  these are mixed in use, as the links in site/slashcode.local/htdocs point to different places:
<pre>
admin.css -> /usr/local/slash/themes/slashcode/htdocs/admin.css
base.css -> /usr/local/slash/themes/slashcode/htdocs/base.css
comments.css -> /usr/local/slash/themes/slashcode/htdocs/comments.css
handheld.css -> /usr/local/slash/themes/slashcode/htdocs/handheld.css
ostgnavbar.css -> /usr/local/slash/themes/slashcode.com/htdocs/ostgnavbar.css
print.css -> /usr/local/slash/themes/slashcode/htdocs/print.css
slashcode.css -> /usr/local/slash/themes/slashcode.com/htdocs/slashcode.css
slashcode_lite.css -> /usr/local/slash/themes/slashcode/htdocs/slashcode_lite.css
slashcode_low_bw.css -> /usr/local/slash/themes/slashcode/htdocs/slashcode_low_bw.css
</pre>





Revision as of 20:17, 20 February 2014

Notes

There are currently three themes in slash/themes:

slashcode - seems to be primary theme used.
slashcode.com   - the slashcode.css used seems to be here. Also ostnavbar.css see below.
useperl

Apparently these are mixed in use, as the links in site/slashcode.local/htdocs point to different places:

 admin.css -> /usr/local/slash/themes/slashcode/htdocs/admin.css
 base.css -> /usr/local/slash/themes/slashcode/htdocs/base.css
 comments.css -> /usr/local/slash/themes/slashcode/htdocs/comments.css
 handheld.css -> /usr/local/slash/themes/slashcode/htdocs/handheld.css
 ostgnavbar.css -> /usr/local/slash/themes/slashcode.com/htdocs/ostgnavbar.css
 print.css -> /usr/local/slash/themes/slashcode/htdocs/print.css
 slashcode.css -> /usr/local/slash/themes/slashcode.com/htdocs/slashcode.css
 slashcode_lite.css -> /usr/local/slash/themes/slashcode/htdocs/slashcode_lite.css
 slashcode_low_bw.css -> /usr/local/slash/themes/slashcode/htdocs/slashcode_low_bw.css


Official docs for themes from docs/HOWTO-Themes.pod

HOWTO-Themes - How to write and use Slash themes

=head1 QUESTIONS

=head2 What is a theme?

A theme is a website design. It can have some functionality
to it (for example, the slashcode theme is a weblog). Functionality,
though, is normally split into seperate plugins.

=head2 How do I get my theme into the install system?

There are two ways to do this. First, you can put it in the
themes directory with the distribution. During the install it
will be copied to the themes directory (by default,
F</usr/local/slash/themes/>. The second option is to copy it in there
yourself. The directory layout is very important with themes.
The install expects to find a sql directory with a mysql and postgresql
directory in it. It expects a templates directory with templates in it and
finally it expects an htdocs directory. It copies files 
directly from htdocs to the install's directory.
Look at the slashcode theme as an example.

=head2 What does my theme need to make it work with the install?

Just the directory structure explained above. Right now there
is no THEME file like there is a PLUGIN file for PLUGINS.
Expect this to change at some point in the future.

=head2 I have a really cool theme and I would like to see it added to the Slash
distribution. Will you distributed mine?

Maybe. We don't have any rules concerning this at the moment, so it will be
on a case by case basis. At some point in the future we will come up
with a much better answer.