#264 ✓resolved
Alex Coles

DataMapper Wiki should adopt Collective

Reported by Alex Coles | May 8th, 2008 @ 05:59 PM

The DataMapper wiki should be migrated to Collective. Although its pretty basic, its being used by Merb.

Although DokuWiki is pretty stable - it would be good for DM to "eat its own dogfood" further down the road (even if Collective is currently based on 0.3).

Steps-necessary to migrate content:

  • script to parse text files (and tar.gz bundles of revisions) and import them into Collective db.
  • DokuWiki => Textile converter? (or mod Collective to use Dokuwiki syntax)

Comments and changes to this ticket

  • Sam Smoot

    Sam Smoot May 8th, 2008 @ 06:37 PM

    Agree 100%. I'd love to see this happen!

    The Wieck team isn't going to have time for this unfortunately right now while we're pushing on 0.9.0, but I'd be happy to give you or someone else SSH access to make it happen.

  • Alex Coles

    Alex Coles May 9th, 2008 @ 06:55 AM


    Happy to help out and do this. Question: Collective doesn't have

    authentication at the moment. Do you want to restrict updating,

    editing pages to authenticated users?

  • Alex Coles

    Alex Coles May 9th, 2008 @ 07:03 AM

    There is now very rudimentary (basic authentication) support in the master branch of Collective (don't think merbivore has deployed it yet) for editing, marking/unmarking as spam.

  • Michael Klishin (antares)

    Michael Klishin (antares) May 9th, 2008 @ 07:46 AM

    I'd love to see Collective adopted by DataMapper wiki also use DM 0.9 and post a tutorial on what's been done to get the whole thing running.

    Right now I see the only way of learning 0.9: by reading specs and sources. It is perfectly fine with me but you cannot quickly start developing a web app like this.

  • Alex Coles

    Alex Coles May 9th, 2008 @ 08:50 AM

    Sure. I am working on porting the code to DM 0.9 - I'll submit a patch

    to the Collective guys, or push it out to my fork.

  • Alex Coles
  • Michael Klishin (antares)

    Michael Klishin (antares) May 9th, 2008 @ 07:55 PM


    I did a fork and will try to follow your changes. If you have idea on how we can separate work here, I'd love to join.

  • Alex Coles

    Alex Coles May 10th, 2008 @ 09:55 AM


    Hi Michael,

    Help would be much appreciated. Two things you could help out and take

    a look out:

    • getting the callback "before :save, :build_new_version" (line 19

    in page.rb) working

    • look through the FIXMEs
    • also I am personally having some issues with the autotest and have

    been renaming the folder in order to work on the code.

    Contact me directly at alex at alexcolesportfolio dot com if you like,

    or hit me up on IRC, and I can give you a more detailed run down.



  • Jed Hurt

    Jed Hurt May 10th, 2008 @ 01:10 PM

    I'm stoked to see Collective getting some traction. It's good motivation to keep plowing forward with it :)

    re:authentication—The edits controller has been deployed at the Merbivore wiki since the initial launch. It's only used for training Defensio and uses http_authentication. There's nothing in place to require user authentication for editing the wiki.

    It was a goal early on to find a solution that allowed anonymous editing of the wiki (thus lowering the barrier to contribution). Defensio has turned out to be a great solution.

    Now that multiple projects will be using Collective, I'm going to create a Lighthouse tracker for it and I'll pick up the development pace a bit.

  • Jed Hurt
  • Alex Coles

    Alex Coles May 10th, 2008 @ 01:35 PM

    @Jed I think it needs a login?

  • Jed Hurt
  • Jed Hurt

    Jed Hurt May 10th, 2008 @ 01:45 PM

    On Sat, May 10, 2008 at 12:35 PM, Lighthouse


  • Adam French

    Adam French May 12th, 2008 @ 01:29 AM

    • Assigned user set to “Adam French”

    I'll do some investigation into what it'll take to get Collective deployed on wiki.datamapper.org on monday

  • Alex Coles

    Alex Coles May 12th, 2008 @ 06:30 AM


    @Michael: Any success with looking through my FIXME's? I was going to spend another hour or two looking through Collective today.

  • Michael Klishin (antares)

    Michael Klishin (antares) May 12th, 2008 @ 07:25 AM


    No good news from me yet, I'll spend some time on it today again.

  • Alex Coles

    Alex Coles May 12th, 2008 @ 07:35 AM

    No problem. Just let me know. I'll put off doing anything til this


  • Jed Hurt

    Jed Hurt May 13th, 2008 @ 01:48 AM

    I made a good deal of progress today on readying Collective for general use. Collective is now easily themeable with a custom stylesheet. I haven't pushed the changes to github yet, but will probably do so tomorrow. Follow the ticket here: http://falsetto.lighthouseapp.co...

  • Alex Coles

    Alex Coles May 15th, 2008 @ 12:26 PM

    I have created a wiki page which breaks down some of the issues into more detail:


  • Jed Hurt

    Jed Hurt May 15th, 2008 @ 12:33 PM

    Hey Alex,

    I checked out the dokuwiki page. Regarding converting the DataMapper.org markup to HAML to be used for the wiki:

    If we're able to achieve a satisfactory DataMappery look by only editing theme.sass, I'd recommend not changing the markup. This would require someone to maintain a fork of Collective with the DataMapper.org specific markup and constantly resolve merge conflicts to keep it up to date.

  • Alex Coles

    Alex Coles May 15th, 2008 @ 07:10 PM

    I don't quite get what you mean about not changing the markup? Do you

    mean the markup in the other sass files, and not theme.sass?

    Maintaining a fork just for theme support is not the way to ago

    (although I guess something like Braid/Giston might help, but I'd

    still rather not go there.

    Other than a customized theme for DM, any other changes we make (e.g.

    code to make it work on 0.9), would probably be ones you'd want to

    incorporate upstream.. so, again, a fork is not the way to go.

  • Jed Hurt

    Jed Hurt May 16th, 2008 @ 12:46 AM

    Ahhh, I think we have our wires crossed. By "markup" I mean the HTML. I thought you were suggesting that we change Collective's HTML to resemble what you'd get by view sourcing datamapper.org.

    You're correct that the goal is to simply change the colors (maybe images too) in the theme.sass file to make the look more like datamapper.org. So we're in agreement ;)

  • Alex Coles

    Alex Coles May 16th, 2008 @ 03:10 AM

    Yep.. sorry I thought you were referring to the SASS markup, and not the HAML/HTML..

    We're in agreement!

  • Adam French

    Adam French May 20th, 2008 @ 09:48 PM

    • State changed from “new” to “open”

    what's the status on the 0.9 port, guys?

  • Alex Coles

    Alex Coles May 22nd, 2008 @ 06:54 AM

    Back on this today. Still working out a couple of bugs/issues (both with DM and with the application). One of which is here: #300.

    @Adam Should be ready for launch date, if you're around to help deploy this weekend?

  • Adam French

    Adam French May 22nd, 2008 @ 10:14 AM

    @alex - not sure. I'm traveling down to houston this weekend to spend the memorial day weekend with the parents. I do typically get online in the evenings, though, when those old foggies go to bed ;-)

  • Alex Coles

    Alex Coles May 23rd, 2008 @ 05:30 AM

    @Adam - no problem. As I said on #datamapper, if we have time to get this up great, but if it slips beyond the 26th, I don't think its going to be too much of an issue.

  • Jed Hurt

    Jed Hurt July 2nd, 2008 @ 01:17 AM

    • Tag set to dm-www, documentation, suggestion, wiki

    It looks like jeffbski "knocked out"http://github.com/jeffbski/collective/commit/52605c73c7920ca66d3c1608a330523195813898 the port to DM 0.9.4. It looks like there are now three forks of Collective with DM 0.9 support ( joe, myabc, and jeffbski )

    Now which one do I pull?

  • Jed Hurt

    Jed Hurt August 26th, 2008 @ 05:07 PM

    I've finished the port to DM09. Collective currently runs on Edge Merb and DataMapper. Is there still any interest in adopting Collective for the DataMapper wiki?

  • Alex Coles

    Alex Coles August 26th, 2008 @ 05:20 PM

    I am in agreement with this still!

    I know we moved away from DokuWiki - to GitHub wiki - but for a user- facing wiki, GitHub's wiki just doesn't cut it. User documentation needs something more powerful that integrates with the DM website.

  • Sam Smoot

    Sam Smoot August 26th, 2008 @ 06:47 PM

    Is there a Collective wiki online anywhere I could check it out and poke around a bit?

  • Michael Klishin (antares)
  • Jed Hurt

    Jed Hurt August 27th, 2008 @ 05:10 AM

    I'm going to be adding RSS feeds and OpenID support over the next week or two. Also, Collective supports a custom stylesheet for themability. I've attached images of the default theme and the Merbivore theme so that you can get an idea of the possibilities.

  • Jed Hurt

    Jed Hurt August 27th, 2008 @ 05:13 AM

    • no changes were found...
  • Jed Hurt

    Jed Hurt August 27th, 2008 @ 05:13 AM

    • no changes were found...
  • Jed Hurt

    Jed Hurt August 30th, 2008 @ 04:02 PM

    I created a custom theme for Collective to make it look more like datamapper.org. I made a userstyle so you guys could check it out. The User Style applies to http://wiki.merbivore.com. Note: All of the !importants in the user style are only necessary because they have to overwrite the Merb Wiki's custom stylesheet. They won't be there in the actual stylesheet.

    I also updated the code highlighter on my local machine to look like the code snippets at datamapper.org. I've attached a screenshot.

    One big change you'll notice is that the theme I made uses a light background for the body copy, instead of the dark one at datamapper.org. I've heard a lot of complaints on dark backgrounds in my day. But if everyone prefers to stick with the dark, that's no problem.

    Anyhoo, please let me know what you think.

  • Alex Coles
  • Jed Hurt

    Jed Hurt August 30th, 2008 @ 04:22 PM

    I just realized that some people may not want to hassle with installing the user script, so here's a screen shot with it applied.

    If we have a host, I'd be happy to deploy the wiki and migrate content from the old DokuWiki if it's still relevant.

    Maybe EY would be willing to donate a slice?

  • Alex Coles

    Alex Coles August 30th, 2008 @ 04:45 PM

    I think there are a few worthwhile pages still in the old Dokuwiki and was disappointed when it disappeared.. it'd be good to have some of the content back (if only for historical reference/a basis for building out the new wiki).

    I don't know how much time is worth spent on porting over content - here are a few thoughts: - in doing my research for this a couple months I found this module: http://search.cpan.org/dist/HTML... . Unfortunately its Perl. I don't know how inclined you'd be to writing a little bit of Perl (in my case, not very...) - previous Dokuwiki histories would be nice-to-have, but I don't think are v. necessary. - if a script-based approach takes more than a couple hours, I'd say its not worth it. Copy and paste the text, and I'm up for helping convert to Textile formatting by hand (and pruning the out of date content).

    On Aug 30, 2008, at 11:23 PM, Lighthouse wrote:

  • Jed Hurt

    Jed Hurt August 30th, 2008 @ 04:55 PM

    Where can I get the old wiki with the DB dump?

  • Adam French

    Adam French August 30th, 2008 @ 08:12 PM

    the box it was on has since been repurposed and reformatted. Plus it was Dokuwiki so it wasn't DB based either.

    Best bet would be google cache

  • Jed Hurt

    Jed Hurt August 31st, 2008 @ 12:01 AM

    I tried the Google cache and archive.org and came up empty handed. Guess we're starting with a fresh install.

    Where was the old wiki hosted? Can we host the new wiki there?

  • Adam French

    Adam French August 31st, 2008 @ 08:21 PM

    likely yes, but I'll ask the right people come tuesday morning

  • Alex Coles

    Alex Coles September 3rd, 2008 @ 03:15 PM

    Any news on this getting approval from the relevant folks?

  • Dan Kubb (dkubb)

    Dan Kubb (dkubb) November 28th, 2008 @ 02:29 AM

    • State changed from “open” to “resolved”
    • Assigned user cleared.

    Since there hasn't been any activity on this in a long time I am going to close it.

    It appears as if the decision was made to go with DocoWiki, and while I prefer the old site design more, I've heard that the Wiki is easier to update than the web pages were.

    I still think the ideal would be to have something similar to the old design, while at the same time using a Wiki to allow easy site updates.

    However, if anyone here is actually interested in setting up Collective (or another DM backed Wiki) to replace DocuWiki on datamapper.org please create a new ticket, and reference this one.

Please Sign in or create a free account to add a new ticket.

With your very own profile, you can contribute to projects, track your activity, watch tickets, receive and update tickets through your email and much more.

New-ticket Create new ticket

Create your profile

Help contribute to this project by taking a few moments to create your personal profile. Create your profile »