DonationCoder.com Forum

DonationCoder.com Software => The Getting Organized Experiment of 2007 => Older DC Contests and Challenges => GOE 2007 Challenge Downloads => Topic started by: Arjen on November 29, 2007, 04:09 PM

Title: PlainTextWiki Toolkit - GOE Challenge 2007 Entry
Post by: Arjen on November 29, 2007, 04:09 PM
Here's my entry:

PlainTextWiki Toolkit 0.1 PREVIEW

Introduction

I was inspired for this program by the PlainTextWiki bundle by Matt Webb (http://interconnected.org/home/2007/05/20/plain_text_wiki) for the MacOS editor Textmate. I've never used it but liked the idea very much.

The idea of a PlainTextWiki is to bring (some) wiki functionality to your text editor. The most important function is that you can include wiki links in your text file. When you move your cursor to that link and press a keyboard shortcut, that link will be opened in your editor.

The PlainTextWiki bundle works only in TextMate. My intention with the PlainTextWiki Toolkit is to make a small program that gives you this function in any text editor that has decent support for external tools. (See what I mean by "decent" below!)

I've called this version a "preview version" because it has only basic functionality: it only allows you to "follow a wiki link" in a text file. In my opinion should have some more functions for a "real" release.

How to install

The program is a command line utility that you can just copy anywhere on your harddrive. It requires the .NET Framework 2.0 (http://download.microsoft.com/download/a/a/c/aac39226-8825-44ce-90e3-bf8203e74006/dotnetfx.exe) to run.

You plug it into your editor by defining it as an external tool. How to do this depends on your editor. Below, I have described how to do this for EditPlus and TextPad.

How to use

In your text editor, you define a wiki link as follows: [[My document]]. Essentially, the link is the name of another text file enclosed by double square brackets. Now, when you "follow this link" (i.e. put your cursor on it and call the PlainTextWiki tool), your editor should open the document "My document.txt". (Note that the extension is always .txt and is not included in the link.)

Command line options

The PlainTextWiki tool should be called as follows:

  plaintextwiki -f <filename> -L <line> -C <column> -e <editor-path> -p <editor-parameters>

Where:

  <filename>: name of the file you're currently editing.
  <line>, <column>: position in the file.
  <editor-path>: path to your editor.
  <editor-parameters>: command line paramaters for your editor to open a new file (in the same instance). The string "$f" in this path will be replaced by the filename to open (the file the wiki link points to).

As you can see, this imposes the following requirements on your editor (at least for this version):


Installation details

EditPlus

[ You are not allowed to view attachments ]

Open the menu Tools > Preferences and go to Tools > User Tools.

Define a new tool with the following options:


TextPad

[ You are not allowed to view attachments ]

Open the menu Configure > Preferences and go to Tools.

Define a new tool with the following options:


Make sure you have the option "Allow multiple instances to run" turned OFF under Configure > Preferences > General, otherwise files will be opened in a new instance of TextPad.

Your Favorite Editor

If you've configured your editor for the PlainTextWiki Toolkit, please share with others by posting below!

Video demo

Here's a short video (http://www.codingspace.org/files/plaintextwiki.html) where you can see how to configure and use the PlainTextWiki Toolkit.

[ You are not allowed to view attachments ] (http://www.codingspace.org/files/plaintextwiki.html)

Some ideas for the future


Have fun and please let me know your comments and suggestions!

Download: [ You are not allowed to view attachments ]
Title: PlainTextWiki Toolkit - GOE Challenge 2007 Entry
Post by: mouser on December 02, 2007, 09:08 AM
great work app and tinjaw!!
Arjen, plaintextwiki looks really cool!
blaster and tpreal -- great to see you guys in this  :up:

arjen a suggestion (actually this suggestion might be useful for everyone):
grab a screencasting tool (camtasia old v3 -- free, wink -- free, bb flashback express -- cheap), and make a screencast showing how to use it.  I suggest it for plaintextwiki mainly just because its a cool idea that people might need to see in action to understand.
Title: PlainTextWiki Toolkit - GOE Challenge 2007 Entry
Post by: Arjen on December 02, 2007, 10:58 AM
arjen a suggestion (actually this suggestion might be useful for everyone):
grab a screencasting tool (camtasia old v3 -- free, wink -- free, bb flashback express -- cheap), and make a screencast showing how to use it.  I suggest it for plaintextwiki mainly just because its a cool idea that people might need to see in action to understand.

Video added! Simple and without audio, but hopefully makes things clearer!
Title: PlainTextWiki Toolkit - GOE Challenge 2007 Entry
Post by: mouser on December 02, 2007, 11:15 AM
go for it urlwolf, there's still time for your entry.

Excellent work arjen!
i think it could have used a few more examples of it being triggered, to jump between files -- but it's great, one gets the idea.
very useful tool too!
Title: Re: PlainTextWiki Toolkit - GOE Challenge 2007 Entry
Post by: Armando on December 05, 2007, 09:04 PM
Arjen : could MS Word or another word processor use such a script ?  :-[ sorry if it's a stupid question...
Title: Re: PlainTextWiki Toolkit - GOE Challenge 2007 Entry
Post by: Arjen on December 06, 2007, 02:18 AM
Hi Armando,

The short answer: no.

The long answer:

The PlainTextWiki tool is a simple command line program that searches for a wiki link in your text file and opens it in your editor.

As such, you need a text editor that supports external tools and can pass the required parameters to PlainTextWiki. (See the readme file for more info.)

MS Word or most other word processors won't be able to use this tool, because:


Sorry!
Title: Re: PlainTextWiki Toolkit - GOE Challenge 2007 Entry
Post by: urlwolf on December 06, 2007, 05:56 AM
I used a plain text wiki for a while. It was vim-specific (the name is viki).
It was fun while I was using a big arse text file for diary/todos... then I moved to onenote.
Title: Re: PlainTextWiki Toolkit - GOE Challenge 2007 Entry
Post by: Armando on December 06, 2007, 06:19 PM
Thanks for the short and long answers, Arjen.  :)
Having a "wikiword script" for Word is one of these little things that I keep hoping will appear... ( https://www.donationcoder.com/forum/index.php?topic=9502.0 ). It's not an obsession though... just something that looks like it would make a positive difference in my work flow.
Title: Re: PlainTextWiki Toolkit - GOE Challenge 2007 Entry
Post by: mucksen on December 08, 2007, 08:15 AM
If you like this you should have a look at http://www.jhorman.org/wikidPad/