spiralofhope logo
S
piral of Hope
Better software is possible.
Styles
Table of Contents

See also search engine optimization (SEO)

  1. After various validations pass, and I hand-check things according to [1], add Viewable With Your Favorite Browser into he footer.
    1. Later, write an essay on this topic and link to it from the footer, and instead link to anybrowser.org from the essay.
  2. RSS
    1. www.w3.org/RDF/Validator/
    2. rss.scripting.com/
    3. feedvalidator.org/

HTML  § 

The executable, not the Ruby library.

I pass everything through HTML Tidy. It's actually extremely difficult to build everything from scratch and be compliant. There are a number of things I do which are clumsy right now. HTML Tidy is a cheat.

I build everything to be XHTML 1.0 strict.

Tested and works on Unity Linux 64bit rc1 as of 2010-04-25:

 cvs -d:pserver:anonymous@tidy.cvs.sourceforge.net:/cvsroot/tidy login 
# press enter
cvs -z3 -d:pserver:anonymous@tidy.cvs.sourceforge.net:/cvsroot/tidy co -P tidy
cd tidy/build/gmake
make
su
smart install libxslt-proc
make install

The command I use is:

 system( 
'tidy',
'-clean',
'-quiet',
'-omit',
'-asxhtml',
'-access',
'-modify',
'--drop-empty-paras', 'true',
'--indent', 'true',
'--indent-spaces', '2',
'--keep-time', 'true',
'--wrap', '0',
'--force-output', 'true',
'--show-errors', '0',
'--show-warnings', 'false',
'--break-before-br', 'true',
'--tidy-mark', 'false',
'--output-encoding', 'utf8',
'--escape-cdata', 'false',
'--indent-cdata', 'true',
'--hide-comments', 'true',
'--join-classes', 'true',
'--join-styles', 'true',
source_file_full_path
)

For additional options, check out tidy -help-config

CSS  § 

jigsaw.w3.org/css-validator/

I use the Mozilla-only rounded corners CSS, so I fail validation.

check spiralofhope.com

Links  § 

I don't understand why their checker doesn't allow checking of its own links, probably for traffic reasons. I have no robots.txt disallow for them.

check spiralofhope.com

JavaScript  § 

See JavaScript for the list of features used with it.

My knowledge of JavaScript is sorely lacking. There are a few things I've copied from elsewhere which are pretty critical which are not standards-compliant. I just don't know enough to fix or replace what I'm doing..

JavaScript function-links are not actually valid. I've tried all sorts of stuff, but the best I can do is to wrap such things inside of <script type="text/javascript"> so that it'll only appear when JavaScript is enabled. Example link:

<a href="javascript:toggle('styles')">

To fix the validation issue, I started doing:

<a accesskey="t" href="/javascript.html#s0" onClick="javascript:toggle('styles');return false">Styles</a>

.. this forces me to have the link though. While this isn't really what I wanted, it does give an opportunity to link to another page explaining what JavaScript would have allowed the user to do.

JavaScript document.write technically shouldn't have HTML opening tags within it. Tidy HTML will escape any forward slashes in opening tags, ruining the code. I've never found a way around this. If I put only ending HTML tags inside the JavaScript - which is valid - and the other text outside, I still get validation errors. I have found no way around this. Example code:

<script type="text/javascript"><!-- 
var heredoc = (<r><![CDATA[
<p>some example text</p>
]]></r>).toString();
document.write(heredoc);
//--></script>
<noscript>
</noscript>

Robots.txt  § 

Checkers:

Internet Archive

Google

Microsoft

Yahoo (Switching to Microsoft's bing.com engine: [6] [7])

Cuil

I have a plain html sitemap file, but there is also a sitemap XML standard:

In robots.txt, add something like:

Sitemap: http://example.com/sitemap.xml

Multiple lines for multiple sitemaps is allowed.

RSS  § 

(Not implemented yet)

Server  § 

Since this engine doesn't really care about the functionality of the server, I don't have much to say about it.

Misc. notes:

Email  § 

I'm not using self-hosted email right now.

web stats