Contents
User contributions
Opening a webbrowser automatically
Suggest also to open web browser with url of desktop wiki. Edit moin.py, line 11:
import os, sys, webbrowser
Then at end of script:
# Run browser iface = Config.interface or 'localhost' url = "http://" + iface + ":" + str(Config.port) webbrowser.open(url) # Run moin moin server: run(Config)
Running on Mac OS X
manually
- After downloading and decompressing Moin Desktop, place it somewhere on your hard drive (these steps are written assuming you will place it at the root level of your home folder).
- Open Terminal (/Applications/Utilities) and type in the command "~/moin-desktop/moin.py" (again, this path assums you placed Moin Desktop at the root level of you home folder). You will see a terminal window open with a message that Moin is active of port 8080.
Open your browser and point it to http://localhost:8080.
Some other things to know:
- In the Terminal window you can type control-c to kill the Moin Desktop server.
- The Terminal window running the Moin Desktop server must stay open (you can hide it but don't close it) to allow the server to work, not very Mac-like but necessary.
- Safari will not allow you to use the GUI editor, use Firefox if you want this feature.
- You can save the command to run moin.py in a Terminal command file to have a double-clickable icon for launching Moin Desktop (or to use with your Login Items in System Preferences).
Creating a double-clickable launch file (easier)
While you can continue to launch the wiki by dragging the moin.py file onto an open Terminal.app window and hitting return to run it; you may want something a little more double-clickable.
Using your favorite text editor (hint: Textwrangler.app, TextEdit.app (set in "plain text" mode)), create a new file and paste in the following:
{{{#!/bin/bash python ./moin.py & }}}
Save it with a name like Launcher.command into the same directory as the moin.py file (the .command extension is important as it will associate that file with Terminal.app.
You will need to change the file so that it's executable, otherwise you'll get an error saying that it cannot launch it. Using Terminal.app, navigate to your file and type: chmod +x launcher.command and hit enter. (for the commandline-timid, check out BatChmod: http://macchampion.com/arbysoft/).
You need to ensure that your Launcher.command file will properly open in Terminal.app (and not the text editor you used to create the file). Simply "Get Info" on Launcher.command and from the "Open with" pop-up menu, select Terminal.app (I generally click "Change All..." to associate all .command files for good measure).
- That's it! For now on, launcher.command is a quick and easy to get going!
Creating an Application (harder)
The below steps are optional. It is not required to run MoinMoin wiki on a Mac (see instructions above), but these steps will make a Mac-like "app".
If you don't already, you will need to install DeveloperTools. DeveloperTools comes with every Mac, but it isn't installed by default. On new Macs, the installer is on the root of your hard drive. Otherwise, it's on a separate CD that came with your MacOS X purchase. Once installed, it should be in: /Developer/Applications/Utilities/MacPython-2.X/BuildApplet.app.
Extract moin-desktop-1.5.X-X.tbz anywhere you like.
Drag moin.py onto the BuildApplet.app icon. A file moin.app will be created in the same folder as moin.py.
Ctrl-click on the newly created moin.app and choose Show package contents. Navigate to ./Content/Resources/.
Copy the files and folders moin.py, MoinMoin, wiki and wikiconfig.py into the Resources-folder. You may or may not choose to replace moin.py (as they should be identical).
You're done! Double-click moin.app.
Running as Service on windows
(If you're considering running Moin as an internal wiki for your organization, you should consider installing the full Moin wiki using the straightforward instructions at HelpOnInstalling/ApacheOnWin32. You can easily then authenticate against a Windows Domain Controller and also gain the killer feature "email notifications".)
Using two simple Microsoft tools from the Windows 2003 Server Resource Kit (which also works for XP), the Registry Editor and the Services applet you can set up MoinMoin DesktopEdition to run as a service. This means that it will always start up and shut down with your machine; there is no need anymore to explicitly start moin.exe.
See this article to download the programs srvany.exe and instsrv.exe (30KB download) (there you can read further but everything is explained in this page). You can also get these tools from Microsoft, but they are 'hidden' in the Windows 2003 Server Resource Kit which is a 12MB download. Your choice.
Now do it. Follow any of the following alternatives
Doing all by hand (works but hardly)
(see later what CarlosBandar did, only for Windows XP, quite easy to have it running as a service!!)
Here is what I (who?) did:
Download srvany.zip from the above site (or here: http://www.tacktech.com/download.cfm?file=microsoft/service/srvany.zip ).
Install the srvany.exe and instsrv.exe whereever you find convenient. I put them in my c:\WINDOWS directory, if you are uncomfortable with that you can put them in some other path.
In a command window (Start --> Run... --> cmd) type:
c:\WINDOWS\instsrv.exe "MoinMoin desktop edition" c:\WINDOWS\srvany.exe
Where you should replace c:\WINDOWS with the path where you installed your srvany and instsrv executables. You should now see a message saying that the service was installed.
Now start up the Registry Editor (Start --> Run... --> regedit and find the following key:
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\MoinMoin desktop edition.
From the Edit menu click New --> Key and give it the name Parameters.
- Select the Parameters key.
From the Edit menu click New --> String Value and give it the name Application.
Double-click on the Application value and enter into the Value field the command to be used to start the application, depending on the particular desktop version you are running.
If you are using the Windows self-contained version, then enter the command to run moin.exe, including the absolute path to the file moin.exe.
Example: C:\wiki\MMDE\moin.exe
If you are using the Python version, with Python installed externally, then enter the command to have the Python interpreter run the moin.py file, including absolute paths to both files.
Example: C:\Python24\python.exe c:\wiki\moin-desktop\moin.py
Do not put quotation marks around this command, even though it contains an embedded blank.
But you can put quotation marks around the file spec, such as in C:\Python24\python.exe "c:\Documents and Settings\...\moin.py" --AnonymousCoward
- Close the Registry Editor.
Open the Service Applet from the Control Panel (Start --> Control Panel --> Performance and Maintenance --> Administrative Tools --> Services), select the service named "MoinMoin desktop edition" and press "Start the service".
- Close the Service Applet.
Now if you open up your browser you should be able to access your MoinMoin desktop edition server in the usual way. Shutting down and restarting your machine will stop and restart this service and allow you to use MoinMoin anytime.
(re: running as a service -- see also XYNTService, which is an easy little util that can run anything as a service.)
CarlosBandar did this way (only Windows XP) quite easy!
No registry editing, just copy from here and paste!
Let´s suppose you have moin.exe in C:\ProgramFiles\MyWiki\moin.exe
Extract srvany to a folder, for the given example C:\ProgramFiles\SrvAnyMyWiki
In the above srvany folder, create a .reg file, for example named configuremywikiservice.reg
Contents, copy from here (change moin.exe path as per your installation):
Windows Registry Editor Version 5.00 [HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\MyWiki\Parameters] "Application"="C:\\ProgramFiles\\MyWiki\\moin.exe"
In the above srvany folder, create a .bat file, for example named installserviceandgo.bat
Contents copy from here (change instsrv.exe and srvany.exe path as per your installation)
"C:\ProgramFiles\SrvAnyMyWiki\instsrv.exe" "MyWiki" "C:\ProgramFiles\SrvAnyMyWiki\srvany.exe" configuremywikiservice.reg sc start MyWiki pause
Now, click twice on installserviceandgo.bat, when asked reply yes (to install values to registry) and ... MyWiki is ready!!
Somebody could improve the .bat to accept as external parameters the srvany folder location (SrvAnyMyWiki in the example given) as well as the moin.exe location (MyWiki in the example given).
Comments
To run the Desktop edition in the background on my Microsoft XP home computer I renamed wikiserver.py to wikiserver.pyw (this runs the server without the DOS box), created a shortcut and placed shortcut in the Startup folder. May not be a service but no DOS box.
I have tried this Desktop Edition in Win to show people the idea and it is great. Thanks Alexander! :-D -- EduardoMercovich 2004-12-09 13:42:58
Same experience here
- Thanks! Nice being able to give this to people who just need a local MoinMoin installation to start playing around - without being watched by others
-- DavidLinke 2004-12-15 22:29:18
Is there any way to sync content between a Desktop Edition wiki, and a regular install? I'd like to use the DE for note-taking in class, and then trasnfer the days' productivity onto my regular wiki for easy access, but to not have to do so by hand. Is this possible or easy, given the MoinMoin architecture?
There are successful reports of using unison to achieve this.
Not exactly what you describe, but I am synchronizing multiple personal wikis using Subversion: DaveFrey/PersonalWiki/MultipleDesktops -- DaveFrey 2005-07-03 22:38:49
For sharing content on a dualboot system, the Linux version can be run from Windows with just Python installed and the corresponding ext2-disk mounted in Windows using Ext2 Installable File System. Maybe it works the other way around, too, but then you probably need NTFS write-access. GerhardBrandt
Privacy
Really great package (just downloaded, unzipped and started). What about privacy? MoinMoin starts its own webserver. Is it only my firewall which prevent others to check and modify my data?No, just you will be able to access it in the default configuration (i.e. anyone from your PC). Thus it is as safe as any other local data storage without encryption. (The webserver is bound to localhost.) See ../HowToConfigure if you want to change it.
Links to files
I'd like to build a page containing links to files on my hard disk and file servers. Is it possible to define URL links to files?See FileLinks.
Links to local static html files
In order to serve static files using DesktopEdition, copy them into them into the wiki/htdocs/ directory. Then you can use a link like [http:/wiki/myfile.html myfile] to link to the HTML file.Thanks again Alexander for your answers. I found that it seems that it is also possible to put them inside a frame: http://moinmoin.wikiwikiweb.de/MoinMoinTips?highlight=%28frame%29#head-6ca4e282052eb847dad97c0440f133153f12713e
What I personally would add is: ability to put everything on a CD-ROM (so adding python), then haveing an AUTOEXEC.BAT for windows - so that this thing runs per default. I then would suggest that pages are copied to a disk, so that they are editable. I am not sure about Python on CD and I am not a Windows batch writer, but I think this would be cool, because nobody would have to install anything, except the pages. They also should only be copied if they do not already exist. -- vinci 2005-09-07 15:28:36 PS: see also this
- Please sketch a few use cases for that. I do not see them (considering that the user should be able to edit them).
I would use this to show off Moin features somewhere, where no good Internet connection is present. -- ThiloPfennig 2005-09-16 05:58:52
- And how about just burning the MMDE folder to the CD and copying it to the Desktop at the customer etc.?
This surely is possible, but not that cool if you put the CD in and could start - or maybe have a quick question where to put (TMP?) -- ThiloPfennig 2005-09-16 09:39:49
- You can put it anywhere.
Why not use an USB device? Solves all your problems and matches all your needs. -- AdrienBeau
- You can put it anywhere.
- And how about just burning the MMDE folder to the CD and copying it to the Desktop at the customer etc.?
- Please sketch a few use cases for that. I do not see them (considering that the user should be able to edit them).
- If you want to enable mail notification, please do not choose the self-contained version.
- In Ubuntu5.10, the Archive Management said "unsupported file formate" when opening the .tbz file. However, after changing the download file name to *.tar.bz manually, it works well.
- I will rename the file in the next release
I upgraded from 1.3.4-2 to 1.5.3-1 and I find the default configuration on ACL generating a tricky behavior. To be precise the line #acl SomeUser:read,write has two drawbacks : it doesn't prevent not logged user to see and modify the page and SomeUser can't change ACLs anymore. This is caused by acl_rights_after = acl_rights_default = u"All:read,write,delete,revert,admin" in wikiconfig.py and by the new control on changing ACLs. The solutions are, respectively :
#acl SomerUser:read,write All: in the wiki page
acl_rights_before = u"SomeUser:read,write,delete,revert,admin" in wikiconfig.py (see MoinMoinBugs/UserAclFails)
- That setting doesn't disallow the user to edit system/help pages. I think that this seems to be an issue with the ACL/underlay design. If you can find an ACL setting that disallows system pages editing and mitigates the above mentioned usability issue, I would be happy.
How can I copy the data to a normal MoinMoin installation?
- Just use any tool of your choice to copy the wiki/data folder to the instance directory of the target installation.
- I put moin-desktop in my home floder, and when I run moin.py, I get this error:
self.socket.bind(self.server_address) File "<string>", line 1, in bind socket.error: (99, 'Cannot assign requested address')
- What should I do to solve this?
Sloved! Thanks to ThomasWaldmann@chat.freenode.net#moin. lo interfaces has not been enabled.(Maybe it's because I can't connect to the network during installation, so debian installer doesn't tune up lo interfaces.)
To enable it:
#editor /etc/network/interfaces
add
auto lo iface lo inet loopback
Then,
#ifup -a py
Now run moin.py, everything is fine.