inserts code from a file: .. literalinclude:: example.py
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
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
A high level over view.
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.
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
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. (Although links may be broken in this scenario)
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
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. Call in your local programmer at this point!
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": ...
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
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