Python Desktop Server Notes

Some notes regarding using Python Desktop Server:

• How to do internal Wiki Links:

  Look in the page AWikiPage_
  

• How to do External Links in reStructuredText:

  Go to `this site`_
  
  .. _this site: http://www.python.org
  

  Note: Back Quotes

• How to do Nuggets

• How to do code blocks:

  .. code-block:: Python
  
    print 'Hello World'
  

  Note: two colons

  Languages supported (to my knowledge): Python, HyperText (for HTML) and XML.

• How to link to a gem:

  .. _here: $macros.absoluteUrl('/gem/blah')
  

  I am not sure this is the best way to do this but it works. If any spaces are in the macro then docutils rejects it. e.g:

  .. _here: $macros.absoluteUrl( '/gem/blah')
  

  will bomb out

• How to get it right first time:

  If you enable the offline mode switch (preferences/basic data/Show on-offline switch) then you can stop Python Desktop Server from uploading your entries until you have got them just right and fixed all those DocUtils quirks. This way the ping servers won't get annoyed when you repeatedly save revisions and ping them.

• How to link to other posts:

  P363_
  

  i.e. post code followed by an underscore.

  (Thanks to Garth T Kidd for this one).

• How to do footnotes:

  I like footnotes [#note]_
  
  .. [#note] When used in moderation.
  

  NOTE: no _ and no colons ¹

[1]	not very consistant.