It's better when it's simple

User Tools

Site Tools


gitlabproject Plugin

Compatible with DokuWiki

  • 2017-02-19 "Frusterick Manners" yes
  • 2016-06-26 "Elenor Of Tsort" yes
  • 2015-08-10 "Detritus" yes
  • 2014-09-29 "Hrun" yes

plugin Gitlab-Project display a Gitlab project inside Dokuwiki.

Last updated on

Tagged with git, gitlab


Download Gitlab Project into your ${dokuwiki_root}/lib/plugins folder and restart dokuwiki or use the Extension Manager.


Default Syntax:

<gitlab project="<NAMESPACE>/<PROJECT_NAME>" />

NAMESPACE is the namespace of your project, typically the name of the user or group in which the project is located.

PROJECT_NAME is the name of project.

For e.g., if you have a project available at http://my-gitlab/foo/bar, the syntax will be:

<gitlab project="foo/bar" />

Override Server and Token

Inside the root of the plugin, you will have a JSON file called: server.json. Inside you can add other servers and their tokens, than the one defined in the plugin settings.

Just call it after by its name.


With the following json file:

    "second": {
        "url": "",
        "api_token": "a1a1a1a1a1a11a1a"
    "third": {
        "url": "",
        "api_token": "b2b2b2b2b2b222b2"

Then, simply add the server parameter with the name you've defined:

<gitlab server="second" project="foo/bar" />

Wrong project or server

If project or server is not available or does not exist, gitlabproject will display a message to warn the user.

Configuration and Settings

You can configure Gitlab-Project in the Configuration Manager of Dokuwiki:

  • server.default: Set your default Gitlab url, without slash ending. You can override this setting in server.json file.
  • token.default: Fill your admin token. You can override this setting in server.json file.
  • unwanted.users: If you want plugin ignore some members of your projects, add them here, separated by commas.

Gitlab-Project will use these data as default.

Change Log

Known Bugs and Issues

Please report your issue or your idea at Gitlab-Project.

plugin/gitlabproject.txt · Last modified: 2017-10-17 09:41 by