By Axel_V on

I have just installed Liquid and I mangaged to get it running (after uncommenting line 73 in liquid_wikipage.module) . I've made a menu entry called 'Wiki', posted my first Wiki page and set it up as Default_page in administere/settings/liquid. All fine, but what next? I open the Wiki page and edit the content: I try to do WikiWords and I try to define links with brackets [[]] as you do in Wikis but it doesn't produce any links. What makes this a Wiki then? I can create new Wiki pages via 'create content' but how do I connect them to my Wiki? I'm sure that Liquid is great but I doesn't come with a lot of exlanation and some other postings show me that I'm not the only one who is a bit puzzled. Who can help?

⋅ Categories: Drupal 4.7.x

Comments

Axel_V’s picture

Axel_V commented

I've now managed to get it going. As I am a newbie with Drupal and not really an expert with PHP and MySQL either here a documentation for other dummies like me who might be facing similar issues with Liquid:
(with Drupal 4.7.2 on MySql 4.0)

1. Even though Liquid is a 4.7.0 module you have to install the tables manually via shell or PHPmyAdmin (as mentioned in the readme.txt)

2. Even if the installation looks successful you might get the following error message if you try to post your first Wiki page via create content:
Fatal error: Call to undefined function node_validate_tithttp://drupal.org/comment/reply/77321#comment_formle() in /var/www/html/market/modules/liquid/liquid_wikipage.module on line 73
In this case open the file liquid_wikipage.module and uncomment the line 73 (by putting '//' in front of it)

3. Create a Menu item (via adminster/menus). You might for example call it MyWiki. As a path to the Wiki define /wiki

4. Go to administer/input formats. Add a new input format. Give it a name, e.g. Wiki. Tick the roles that are supposed to use the Wiki and tick the Liquid MediaWiki Filter (Liquid implementation)

5. Go to create content and create your first wiki page, in my case: Wiki Start Page

6. Go to administer/settings/liquid. Set the default content type to wiki page and the default page to the name of your first wiki page, in my case Wiki Start Page.

That's it. Now you can go to your menu item MyWiki (or whatever you've called it). Edit your first entry and try to produce a link with square brackets: [[my first link]]
Liquid does not seem to accept WikiWords

Please post your comments and improvements and maybe this will develop into some kind of manual for Liquid.

kennyvader’s picture

kennyvader commented

Finally with your help I'm getting somewhere with this liquid wiki module.

Three comments so far:
- unless I'm missing something, you have to manually change the "Input Format" to "Wiki" on every single wiki page you want to edit. Is there any way to have it defaul to input format "Wiki" on pages that are type Wiki Page?
- Liquid can't handle spaces in wiki page ids at all. If you create a link something like [[Page Two]] it gets itself in a horrible mess of trying to substitute an underscore between Page and Two. However, "nice links" in page markup (e.g. [[twoword|two word link]]) do seem to work.
- Tables don't work, not in any wiki markup I know anyway

Axel_V’s picture

Axel_V commented

Thanks for those comments. They reflect my own experience.

Your comments point at another thing for this thread: not everyone knows how Wiki markup language works, maybe not even that they have to use markup language. Sorry to be so basic about this but I think somebody has spent a lot of his valuable time to write this piece of software. So why not make it available to everyone (It is virtually unavailable for many people if not explained properly). For the moment maybe a link would be helpful to the markup language this is based on. Is it right that it is MediaWiki? http://meta.wikimedia.org/wiki/Help:Editing

The table of content (TOC) seems not to work? If I get it right this has been posted as an issue: http://drupal.org/node/58852. So this probably is under construction?

basher’s picture

basher commented

...Having trouble with the uncommenting of the liquid_wikipage.module.

When opening it in notepad I find the following expression in lines 70-76 (spacing not totally accurate in what follows):

71 /**
72 * Implementation of hook_validate().
73 */
74 function liquid_wikipage_validate($node) {
75 node_validate_title($node);
76 }

Not sure about what needs to be modified here...Apologies in advance for the lack of php skills & thanks for your help and attention.

Axel_V’s picture

Axel_V commented

in my liquid_wikipage.module file the line 73 is your line 75:
node_validate_title($node);

basher’s picture

basher commented

Thanks so much

sepeck’s picture

sepeck commented

The author of Liquid started it before 4.7 was released and the .install files were available. He has indicated that his summer work/school would prevent him from working full time on it.

Just an FYI. I'm sure he would welcome patches/assistence.

-Steven Peck
---------
Test site, always start with a test site.
Drupal Best Practices Guide -|- Black Mountain

-Steven Peck
---------
Test site, always start with a test site.
Drupal Best Practices Guide

kennyvader’s picture

kennyvader commented

I think Axel V knows that the original author is busy and is not complaining about that. What he has done and released so far is very good and fills a hole that otherwise means Drupal is out of the running for many projects due to the absence of basic Wiki features. Liquid as it is now gives me back enough wiki features to be getting on with (tables would be nice, but I can just use html for those for now), and the bugs like spaces can be worked around once they are known.

What was greatly missing though was instructions on what to do to make what there is, work. And this is what Axel V means by "unavailable" - he means "inaccessible through lack of install documentation". The readme that comes with the installation package covers about a quarter of the steps you need to take to actually make it function. His initial post above changes that and makes it usable. Hopefully some other similar tips might appear here. Or at least highlight where the documentation is deficient. Which makes things easier for sorenp when he returns or finds some assistance.

I just hope that future upgrades of the Liquid module respect the entries that have already been made with it, but hopefully since I have stuck to MediaWiki markup, it will. I wish there was one decent standard for wiki markup, the MediaWiki stuff is terrible (seemingly created by geeks rather than ordinary people, there are much better markups out there) but it seems to have become a defacto standard, so that's what I force myself to use, for future proofing reasons.

sepeck’s picture

sepeck commented

providing information. Wasn't thinking anything else about it. Certainly collaborating to gather information and document stuff is an excellent thing to do.

-Steven Peck
---------
Test site, always start with a test site.
Drupal Best Practices Guide -|- Black Mountain

-Steven Peck
---------
Test site, always start with a test site.
Drupal Best Practices Guide

pixor’s picture

pixor commented

Thanks for this - I've got a lot further with Liquid now! However, I seem to be stuck in a loop where whenever I try to edit my main page content it complains about it having an invalid wiki ID of "Main Page" (no spaces allowed), but there is nowhere I can change the wiki ID (if I create a new page, there is a wiki section in the configuration where I can enter the wiki ID).

I'm going round in circles with this - can anyone help?

Mike.