DokuWiki Installer

:

This page assists in the first time installation and configuration of Dokuwiki. More info on this installer is available on it's own documentation page.

DokuWiki uses ordinary files for the storage of wiki pages and other information associated with those pages (e.g. images, search indexes, old revisions, etc). In order to operate successfully DokuWiki must have write access to the directories that hold those files. This installer is not capable of setting up directory permissions. That normally needs to be done directly on a command shell or if you are using hosting, through FTP or your hosting control panel (e.g. cPanel).

This installer will setup your DokuWiki configuration for ACL, which in turn allows administrator login and access to DokuWiki's admin menu for installing plugins, managing users, managing access to wiki pages and alteration of configuration settings. It isn't required for DokuWiki to operate, however it will make Dokuwiki easier to administer.

Experienced users or users with special setup requirements should use these links for details concerning installation instructions and configuration settings.

For security reasons this script will only work with a new and unmodified Dokuwiki installation. You should either re-extract the files from the downloaded package or consult the complete Dokuwiki installation instructions

driven by DokuWiki powered by PHP
Updating the .mailmap file [Mantis Bug Tracker Wiki]

User Tools

Site Tools


mantisbt:mailmap

This is an old revision of the document!


Updating the .mailmap file

The .mailmap file allows Git to handle user aliases.

It is useful to maintain a clean and consistent list of authors, for example if users changed e-mail addresses or used different names when checking in their commits.

Identifying duplicate authors in Git history

This section provides command to identify duplicates that would require an entry in the .mailmap file.

If there is no output, then there's nothing to do ! :-)

Multiple e-mail addresses

The following command will print a list of Author names having more than one e-mail address not already aliased in mailmap.

git log --format='%aN <%aE>' | sort -u | awk -F'<' '{print $1}' | uniq -c | grep -v '^ *1 '| cut -c9-

Multiple names

The following command will print a list of Author e-mail addresses linked to more than one name, and not already aliased in mailmap.

git log --format='%aE %aN' | sort -u | awk '{print $1}' | uniq -c | grep -v '^ *1 ' | cut -c9-

Updating .mailmap

Add aliases to the .mailmap file for each entry in the lists generated by the above commands. The following command will identify what needs to be added (replace XXX by the entry)

git log --author="XXX" --format="%aN <%aE>" | sort -u

See Reference section below for details about .mailmap file syntax.

Example

The example below was generated on the MantisBT repository, after deleting .mailmap. For the sake of simplicity, only

  1. Identify
    $ git log --format='%aN <%aE>' | sort -u | awk -F'<' '{print $1}' | uniq -c | grep -v '^ *1 '| cut -c9-
    Victor Boctor 
    
    $ git log --author="Victor Boctor" --format="%aN <%aE>" |sort -u
    Victor Boctor <vboctor@gmail.com>
    Victor Boctor <vboctor@localhost.localdomain>
    Victor Boctor <vboctor@new-host-3.home>
    Victor Boctor <victor@mantishub.com>
    Victor Boctor <victor@mantishub.net>
  2. Edit .mailmap file to add aliases
    Victor Boctor <vboctor@gmail.com> root <root@localhost.localdomain>
    Victor Boctor <vboctor@gmail.com> <vboctor@localhost.localdomain>
    Victor Boctor <vboctor@gmail.com> <vboctor@new-host-3.home>
    Victor Boctor <vboctor@gmail.com> <victor@mantishub.com>
    Victor Boctor <vboctor@gmail.com> <victor@mantishub.net>
  3. Check again: only a single entry is displayed now
    $ git log --author="Victor Boctor" --format="%aN <%aE>" |sort -u
    Victor Boctor <vboctor@gmail.com>

References

mantisbt/mailmap.1565307152.txt.gz · Last modified: 2019/08/08 19:32 by dregad