RemcoBoerma - MoinMoin

Remco Boerma

Email: <r DOT boerma AT SPAMFREE drenthecollege DOT nl>
User on IRC: Gwork

MoinMoin Cheat Sheet:	PDF: Wiki Cheat Sheet V1.0 ENG.pdf
	ODG: Wiki Cheat Sheet V1.0 ENG.odg

	Version 1.0 covers: TextFormatting, Numbered Lists, Tables, Lines, (Sub)Titles and ToC, Numbered Lists, Block Parsers, External Links, Internal Links, Tips and Tricks, Access Rights, Whitespace and breaks.
Comments
-- RemcoBoerma 2008-04-23 13:16:25	Please feel free to add your comments to improve and/or improvise. It's still a draft atm.
-- RemcoBoerma 2008-04-24 13:01:20	Thanks, it's english now, has a 1.6+ sign, and with added boxes. Please comment!
-- ThomasWaldmann 2008-04-24 13:57:46	The "access rights" box has an error: "All:none" is invalid. "All:" maybe is what you want, but even that is only needed in special cases (to take away rights given to All: group by acl_rights_after). If you don't have that special case, you don't give All: rights by not telling anything about All:. Also, placing ACLs on a page requires admin rights - and maybe users of such a cheat sheet don't have admin rights anyway.
-- ThomasWaldmann 2008-04-24 13:57:46	"A soft enter is inserted using `<<BR>>`." Hmm, I never heard "soft enter" in that context before. I would call it a "line break".
-- ThomasWaldmann 2008-04-24 13:57:46	I am not sure if there should be 2 boxes about internal and external links. And maybe it could be shorter and easier to remember by explaining the rules rather than giving examples (at least it would remove some redundancy). Maybe this has to be tested with some unexperienced users what they find easier.

Moin farm admin at the office. Using (2011-07-19):

MoinMoin 1.5.x and 1.6.3 and 1.8.7 and 1.9.3
WikiRPC based search and replace
Custom macros to connect to iET Applix on a database level through xmlrpc server on a windows machine
Graphviz integration (something like GraphVizForMoin). Download GraphViz.py works with 1.6, 1.8 and 1.9. (confirmed on linux)
- you maybe rather want to move this to a market page so that people better find it, see: MoinMoinExtensions
PageComment2 macro extensively
PageDict macro deprecated in favor of MacroMarket/DictColumns
several remote page generating/updating macro's via xmlrpc (See ReimarBauer/xmlrpc if you want to create some of you own)
MacroMarket/SubscribeTo - heavily used for a messagebus architecture at the office.
/WikiPaste - easily cut-exec-and-paste graphic clipboard data to Moin

Using the following snippet in python25\lib\site-packages\MoinMoin\converter\text_html_text_moin_wiki.py:

   1 def convert(request, pagename, text):
   2     # REMCO: start of patch:
   3     # using the tidy lib pasted HTML from word is checked for errors.
   4     # get the tidy lib from : http://utidylib.berlios.de/
   5     import tidy
   6     # i keep getting unicode errors. Trial and error learned me this works:
   7     text2 = text.encode('utf8','xmlcharrefreplace')
   8     # * convert the document, don't do a doctype: it'll crash you..
   9     # * force_output since it will refuse regular input
  10     # * strip microsoft specific stuff
  11     # * and we don't want an entire page, only the body html
  12     options = dict(output_xhtml=1,
  13                    show_body_only=1,
  14                    doctype='OMIT',
  15                    bare=1,
  16                    word_2000=1,
  17                    force_output=1,
  18                    drop_proprietary_attributes=1)
  19     # here comes unicode errors again!!
  20     text = str(tidy.parseString(text2, **options)).decode('utf8', 'xmlcharrefreplace')
  21     # REMCO: end of patch (except 1 u below)
  22     # Due to expat needing explicitly set namespaces, we set these here to allow pasting
  23     # from Word / Excel without issues.
  24     # If you encounter 'ExpatError: unbound prefix', try adding the namespace to the list.
  25     namespace = [u'xmlns:o="urn:schemas-microsoft-com:office:office"',
  26                  u'xmlns:x="urn:schemas-microsoft-com:office:excel"',
  27                  u'xmlns:ss="urn:schemas-microsoft-com:office:spreadsheet"',
  28                  u'xmlns:c="urn:schemas-microsoft-com:office:component:spreadsheet"',
  29                  u'xmlns:s="uuid:BDC6E3F0-6DA3-11d1-A2A3-00AA00C14882"',
  30                  u'xmlns:dt="uuid:C2F41010-65B3-11d1-A29F-00AA00C14882"',
  31                  u'xmlns:rs="urn:schemas-microsoft-com:rowset"',
  32                  u'xmlns:z="#RowsetSchema"',
  33                  u'xmlns:x2="http://schemas.microsoft.com/office/excel/2003/xml"',
  34                  u'xmlns:sl="http://schemas.microsoft.com/schemaLibrary/2003/core"',
  35                  u'xmlns:aml="http://schemas.microsoft.com/aml/2001/core"',
  36                  u'xmlns:w="http://schemas.microsoft.com/office/word/2003/wordml"',
  37                  u'xmlns:wx="http://schemas.microsoft.com/office/word/2003/auxHint"',
  38                  u'xmlns:w10="urn:schemas-microsoft-com:office:word"',
  39                  u'xmlns:v="urn:schemas-microsoft-com:office:vml"']
  40     ## REMCO:                       ! - added this u below
  41     text = u'<page %s>%s</page>' % (u' '.join(namespace), text)
  42     tree = parse(request, text)

Nice. Maybe you want to not make it depend on tidy, just use something like:

try:
    import tidy
except ImportError:
    tidy = None

...

if tidy:
    # code only working WITH tidy installed

Also, please specify what exact problems this "tidy approach" is solving (e.g. which bugs can we close now? :).

-- ThomasWaldmann 2008-03-05 15:49:29

Thanks for the whitespace-pep8-update.. I keep forgetting to remove whitespace around assingments in keyword parameters... The if tidy line i nice indeed. And for what it solves: i can now copy and paste from word directly, or through the word-pate-button with actual contents as a result, instead of errors -- 82.215.27.43 2008-03-08 14:26:27

can you please run py.test and post the results here. I tried to add this patch and I got some strange results. -- ReimarBauer 2008-03-11 23:31:33

import tidy
options = dict(output_xhtml=1, show_body_only=1, doctype='OMIT',
                   bare=1, word_2000=1, force_output=1, drop_proprietary_attributes=1)

test = """<HTML>
<ul>
<li>test</li>
<ul>
<li>test</li>
</ul>
<li>test</li>
</ul>
"""
print tidy.parseString(test, **options)


result is

<ul>
<li>test</li>
<li style="list-style: none">
<ul>
<li>test</li>
</ul>
</li>
<li>test</li>
</ul>

Some days ago I recognized pytidylib and it works very good with a lot of broken html pages I tried. It would be nice to get some feedback from word users or if it should be different configured to solve issues by that. -- ReimarBauer 2010-03-02 19:41:21

That coul be something very interesting. Because we started to use the gui more often, and I would like to copy some stuff from word / outlook 1:1 into the wiki and save the formating (primarily: lists, bold, italic, paragraphs, hierarchy levels, etcetera) without the need to reformatting everything. can I just add this page and see what's happen:-) . Works also with 1.8 or need 1.9? -- MarcelHäfner 2010-03-02 22:46:33

   1 diff -r 67e542fc0f81 MoinMoin/converter/text_html_text_moin_wiki.py
   2 --- a/MoinMoin/converter/text_html_text_moin_wiki.py	Tue Mar 02 21:17:25 2010 +0300
   3 +++ b/MoinMoin/converter/text_html_text_moin_wiki.py	Tue Mar 02 20:36:13 2010 +0100
   4 @@ -17,7 +17,10 @@
   5  from MoinMoin.parser.text_moin_wiki import Parser as WikiParser
   6  interwiki_re = re.compile(WikiParser.interwiki_rule, re.VERBOSE|re.UNICODE)
   7  
   8 -
   9 +try:
  10 +    import tidylib
  11 +except ImportError:
  12 +    tidylib = None
  13  # Portions (C) International Organization for Standardization 1986
  14  # Permission to copy in any form is granted for use with
  15  # conforming SGML systems and applications as defined in
  16 @@ -1435,6 +1438,13 @@
  17      # Due to expat needing explicitly set namespaces, we set these here to allow pasting
  18      # from Word / Excel without issues.
  19      # If you encounter 'ExpatError: unbound prefix', try adding the namespace to the list.
  20 +    if tidylib:
  21 +        text, errors = tidylib.tidy_fragment(text,
  22 +                                             options={'numeric-entities': 1,
  23 +                                             'indent': 0,
  24 +                                             'wrap': 0,
  25 +                                             'output-xhtml': 1})
  26 +
  27      namespace = [u'xmlns:o="urn:schemas-microsoft-com:office:office"',
  28                   u'xmlns:x="urn:schemas-microsoft-com:office:excel"',
  29                   u'xmlns:ss="urn:schemas-microsoft-com:office:spreadsheet"',

pytidy.patch

CategoryHomepage

MoinMoin: RemcoBoerma

Remco Boerma