inserts code from a file:
.. literalinclude:: example.py

http://www.google.com/search?hl=en&safe=off&client=firefox-a&channel=s&rls=org.mozilla%3Aen-US%3Aofficial&hs=CHW&q=restructured+text+insert+text&aq=f&oq=&aqi=
restructured text insert text - Google Search
http://www.google.com/search?q=sphinx+insert+code&ie=utf-8&oe=utf-8&aq=t&rls=org.mozilla:en-US:official&client=firefox-a
sphinx insert code - Google Search
http://broadcast.oreilly.com/2009/02/writing-technical-documentatio.html
Writing Technical Documentation with Sphinx, Paver, and Cog - O'Reilly Broadcast
http://www.google.com/search?q=sphinx+include+sample+code&ie=utf-8&oe=utf-8&aq=t&rls=org.mozilla:en-US:official&client=firefox-a
sphinx include sample code - Google Search
http://sphinx.pocoo.org/rest.html
reStructuredText Primer — Sphinx v0.6.3 documentation
http://sphinx.pocoo.org/markup/code.html
Showing code examples — Sphinx v0.6.3 documentation

written with python
http://mail.python.org/pipermail/python-list/2006-December/589700.html
Python Operating System
http://www.google.com/search?q=Uuu+python&btnG=Search&hl=en&client=firefox-a&rls=org.mozilla%3Aen-US%3Aofficial&hs=f14&sa=2
Uuu python - Google Search
http://jtauber.com/cleese/
James Tauber : Cleese
http://code.google.com/p/cleese/
cleese - Project Hosting on Google Code
http://code.google.com/p/cleese/wiki/CleeseProject
CleeseProject - cleese - Project Hosting on Google Code
http://code.google.com/p/cleese/wiki/ExperimentalSubProjects
ExperimentalSubProjects - cleese - Project Hosting on Google Code
http://www.daniweb.com/forums/thread64256.html#
Operating System in Python - Python
http://en.wikipedia.org/wiki/Unununium_(operating_system
Unununium (operating system - Wikipedia, the free encyclopedia
http://www.google.com/search?ie=UTF-8&oe=UTF-8&sourceid=navclient&gfns=1&q=unununium
unununium - Google Search
http://unununium.org/?page_id=2
About « Unununium Operating Engine
http://unununium.org/
Unununium Operating Engine
http://www.google.com/search?q=real+time+operating+system+python&ie=utf-8&oe=utf-8&aq=t&rls=org.mozilla:en-US:official&client=firefox-a
real time operating system python - Google Search
http://www.faqts.com/knowledge_base/view.phtml/aid/1388/fid/268
FAQTs - Knowledge Base - View Entry - Does Python run on any RTOS? (ie Phar Lap ETS)?
http://mail.python.org/pipermail/python-list/2001-September/106513.html
Realtime capabilities?
http://www.google.com/search?q=embedded+python&ie=utf-8&oe=utf-8&aq=t&rls=org.mozilla:en-US:official&client=firefox-a
embedded python - Google Search
http://stackoverflow.com/questions/1402933/python-on-an-real-time-operation-system-rtos
Python on an Real-Time Operation System (RTOS) - Stack Overflow


the files to look at for default templates:

/c/external/sites/charlesbrandt.com/templates/instances.txt
/c/external/sites/charlesbrandt.com/python/pylons/new_pylons_app.txt
/c/external/sites/charlesbrandt.com/templates/pylons/public/css/style.css
/c/external/sites/charlesbrandt.com/templates/pylons/controllers/main.py
/c/external/sites/charlesbrandt.com/templates/pylons/templates/header.mako
/c/external/sites/charlesbrandt.com/templates/pylons/templates/footer.mako
/c/external/sites/charlesbrandt.com/templates/pylons/templates/site.mako
/c/external/sites/charlesbrandt.com/templates/pylons/templates/main/index.mako





if using the site templates frequently
(and once they stabalize)
would be nice to have a paster

paster serve --reload development.ini

view in firefox:
http://localhost:5000/

if no controller has been created, will get a 404

http://localhost:5000/tester/index
http://localhost:5000/main/index

remove public index.html (otherwise it will be default)
cd (package)/public
#rm index.html bg.png pylons-logo.gif
hg rm personnel/public/bg.png
hg rm personnel/public/pylons-logo.gif
hg rm personnel/public/index.html

#make images and css directories in public:
cp -R /c/external/sites/charlesbrandt.com/templates/pylons/public/css public/
#import other default template files:
cp -R /c/external/sites/charlesbrandt.com/templates/pylons/templates/* templates/
cp -R /c/external/sites/charlesbrandt.com/templates/pylons/controllers/* controllers/

#be sure to choose if you want the sqlalchemy version (model-sa) or non-sa:
cp /c/external/sites/charlesbrandt.com/templates/pylons/model/* model/

update the imports in the controllers you plan to use

update lib/helpers.py to import webhelpers
cp /c/external/sites/charlesbrandt.com/templates/pylons/lib/* lib/

sudo easy_install virtualenv

I recommend Kompozer. It is free, open source and available for all platforms.:

http://www.kompozer.net/
KompoZer - Easy web authoring
http://www.kompozer.net/features.php
KompoZer - features
http://www.kompozer.net/download.php
KompoZer - downloads
http://www.charlescooke.me.uk/web/ugs07.htm
KompoZer User Guide: 7 Templates
http://www.charlescooke.me.uk/web/ugs04.htm#s424
KompoZer User Guide: 4 Style and stylesheets
http://en.wikipedia.org/wiki/KompoZer
KompoZer - Wikipedia, the free encyclopedia


http://en.wikipedia.org/wiki/Website
Website - Wikipedia, the free encyclopedia

Creating a Website
--------------------

A high level over view.

An undefined problem has an infinite number of solutions.
-- Robert A. Humphrey

Many people want to have a website of their own. The first thing to do is to decide on the reason why you want a website. Set a goal for the site, and look for the shortest path to meet that goal.

The next step is to make the site. Remember: keep it simple.

Free Solutions
------------------

The easiest option is to use a free hosted solution like `google sites `_, blogger, wordpress, facebook, myspace, livejournal, twitter, etc. These solutions are *very* user friendly and easy to get started. If you don't have much experience creating web sites, I encourage you to start here. These solutions will help you get familiar with some of the concepts of creating a website.

Even if you want your site to do more eventually, this is a great place to start. Having something in place lets gives you a frame of reference to help you define what else you need. At the very least, you'll start organizing the content you'll need for other solutions. At the very best, this option might do everything you wanted it to. Great!

More information about creating a site with Google Sites is in `google_sites `_

Your Own Domain Name
-----------------------

The next step up on the road of website development is to register your own domain name. If you have your own domain name, you can point it to one of the free hosted solutions already mentioned. With your own domain name, you can always change where it goes. This gives you complete control over what is displayed and how it is displayed. If you change your mind on the system you want to use for the site, you can change it without having to tell people the new address. (Some links to specific content may be broken in this scenario.)

Static Sites
-----------------

The next easiest thing to do for more control over the content is create your website with static content. You will need a way to create the [static content] and a way to host it on a publicly available web server (web host).

If you need a recommendation for a good affordable host, or domain registrar, try Dreamhost:
http://www.dreamhost.com/r.cgi?266169
If you wouldn't mind saying that I referred you, just use that link, or when asked for an email, use admin [at] charlesbrandt [dot] com (formatted as a real email address)

Details about creating a static site are in `static websites `_

Dynamic Sites
-------------------

Middle ground... template based static site generation. (some programming, still static results). python/templates.txt

If you find that you are changing your static content frequently, but have difficulty keeping the navigational elements of your site up to date with the changes, it may be time to investigate a dynamically generated site. These require software or programming to automatically generate the dynamic parts of your site. These solutions may also require a different hosting solution. General solutions fall in the realm of content management systems (CMSes) and custom solutions involve using web frameworks to create web applications, or just starting from scratch with custom code to interact with a database or other storage mechanism. Get ready to do a lot of research, or call in your local programmer at this point!

Other
----------

Documentation specific sites should investigate documentation generation tools like epydocs and sphinx.

Remember: Don't get lost in the infinite ways of presenting your content! Start simple.



how to find the name of the current operating system
best way seems to be to use:
::

sys.platform
if sys.platform == "darwin":
...

http://docs.python.org/library/
The Python Standard Library — Python v2.6.2 documentation
http://docs.python.org/library/os.html
16.1. os — Miscellaneous operating system interfaces — Python v2.6.2 documentation
http://www.google.com/search?q=python+determine+if+operating+system+is+mac&ie=utf-8&oe=utf-8&aq=t&rls=org.mozilla:en-US:official&client=firefox-a
python determine if operating system is mac - Google Search
http://bytes.com/topic/python/answers/576977-how-determine-operating-system-use
how to determine Operating System in Use? - Python answers



deployment is about running your application on a system for someone to use. Usually in the sense of a hosted solution delivered via a network.

see package_code for notes on publishing and releasing packages

sphinx-build -b html . ./_build

sphinx-build -b html . ./.build
or
make html

notes on installing Sphinx from source:

#2009.09.04 09:57:32 charles@context:/media/C/downloads/python/sphinx
tar zxvf docutils-0.5.tar.gz

python setup.py install
sudo python setup.py install

cd ../pygments/
sudo python setup.py install

cd ../jinja2/
sudo python setup.py install

cd ../sphinx
sudo python setup.py install

http://prdownloads.sourceforge.net/docutils/docutils-0.5.tar.gz?download
hg clone http://bitbucket.org/birkenfeld/sphinx/
hg clone http://dev.pocoo.org/hg/pygments-main pygments
hg clone http://dev.pocoo.org/hg/jinja2-main jinja2

adapted from:
http://pylonsbook.com/en/1.0/documentation.html

once sphinx is installed
initialize a new project with:

cd [project]/docs
mv index.txt index.txt.orig
sphinx-quickstart

.txt for extension
yes to autodoc