How to install and use Gollum on vanilla Debian/Ubuntu/Mint machine

Suppose you have a vanilla Debian/Ubuntu/Mint machine and you want to use Gollum – wiki system, built on top of Git and used internally by Gihub wiki pages. Here are the necessary steps:

1. Install required components from OS repositories:

     sudo apt-get install ruby ruby-dev libz-dev libicu-dev build-essential
     

2. Install Gollum from gems repository:

     sudo gem install gollum
     

3. Create test git repository and run Gollum on it:

     mkdir testwiki
     cd testwiki
     git init
     gollum
     

Check: you should see messages like this:

user@host:~/Projects/testwiki$gollum
[2014-05-19 18:58:02] INFO WEBrick 1.3.1
[2014-05-19 18:58:02] INFO ruby 1.9.3 (2012-04-20) [x86_64-linux]
== Sinatra/1.4.5 has taken the stage on 4567 for development with backup from WEBrick
[2014-05-19 18:58:02] INFO WEBrick::HTTPServer#start: pid=27319 port=4567

that means: Gollum is up and running on port 4567.

Now you can launch you favourite browser, enter addresss http://localhost:4567 and start editing wiki pages:

Whenever you save a page, Gollum commits it to git repository. Optionally you can add a message to commit.

It is worth noting, that Gollum supports many important markup languages: AsciiDoc, Creole, Markdown, MediaWiki, Org-mode, Pod, RDoc, reStructuredText, Textile.

When wiki pages are ready to be presented to the world, you push them to github wiki pages. Instructions on pushing to a remote repository are found here.

Advertisements

Gretty version 0.0.16 is out!

I release Gretty (gradle plugin for jetty) version 0.0.16!

New:

• redesigned tasks as two classes: GrettyStartTask and GrettyServiceTask.
• moved documentation from README.md to wiki pages.
• drawn beautiful state diagrams for all Gretty tasks.

Sources and documentation at https://github.com/akhikhl/gretty.

Also available on jcenter & maven central!

Gretty 0.0.14 is out!

Hello there,

Gretty version 0.0.14 is out – on github, on maven central and jcenter!

What’s new: now Gretty supports jvmArgs parameter in plugin extension. See more information in what’s new section of the documentation.

Gretty is a feature-rich Gradle plugin, designed for running Web-Applications on Jetty. See more information in main features section of the documentation.

Many thanks to Justin Munn for contribution!

Gitbucket – your own github-like web-application without a hassle

Meet gitbucket – your own github-like web-application, requiring minimum configuration:

https://github.com/takezoe/gitbucket

Features:

• out-of-the-box HTTP access to git repositories (in browser and from command line)
• web-based user management
• web-based repository management
• issue management, pull-requests, wiki, etc.

Not yet implemented features:

• out-of-the-box SSH support (or integration with SSH-supporting solutions like gitolite)
• online editing

My impression: this is very interesting application that I will certainly use as soon as missing features get implemented.

gradle-onejar plugin version 0.0.5 is out!

I just released gradle-onejar plugin version 0.0.5!

The sources are available at https://github.com/akhikhl/gradle-onejar.

gradle-onejar is a gradle plugin, automating assembly of java application to a single runnable jar.

The plugin is available in maven central under coordinates “org.akhikhl.gradle-onejar:gradle-onejar:0.0.5”

It has many configuration options, described in online documentation.

Your comments and suggestions are welcome – here and at github!

Gretty 0.0.7 is out!

Gretty 0.0.7 (gradle jetty plugin) is out! New: logback re-init on hot-deployment.

https://github.com/akhikhl/gretty

Gretty 0.0.6 is out!

gretty 0.0.6 (gradle plugin) is out!
News: support of jetty 7/8/9, servlet-api 2.5/3.0.1/3.1.0.
https://github.com/akhikhl/gretty
Merry Christmas! 🙂

Meet Gretty: advanced gradle plugin for running web-applications under Jetty and Tomcat

I created little gradle plugin for running web-applications under Jetty 8.1.8.

The main advantage for a programmer is that now it’s possible to use servlet-api 3.0 and higher (under standard gradle-jetty plugin it was not possible, because jetty was too old).

Full sources, documentation and examples here:

https://github.com/akhikhl/gretty

Update 24.02.2014:

Now gretty supports jetty 7, 8 and 9 and servlet API 2.5, 3.0.1 and 3.1.0, as well as it brings many new interesting features!

Update 07.10.2014

Now Gretty supports Tomcat 7 and 8, as well as SpringBoot, spring-reloaded and jacoco!

Automated git-pull

Suppose you have 20 git-repositories, which you actively pull and push from/to central location (e.g. github). Don’t you think pulling them by hand is too mechanical? And what if you forget to pull some?

I wrote little gradle script capable of automated git-pull:

You drink morning coffee and the machine does the job for you.

Credits come to the creators of excellent gradle-git plugin:

https://github.com/ajoberstar/gradle-git