marcelhuberfoo/pandoc-gitit

pandoc-gitit

这个Docker镜像基于marcelhuberfoo/cabal-build镜像构建，集成了Pandoc文档转换器和Gitit Wiki系统，并安装LaTeX工具以支持PDF生成。

核心功能

• 提供非root用户docky及其同名组，用于容器内程序执行；
• docky用户的umask设置为0002；
• 导出UNAME、GNAME、UID、GID环境变量，方便脚本调用用户配置；
• 时区默认链接到Europe/Zurich，可在派生镜像中调整；
• 外部源文件夹可映射到/data卷（默认工作目录）；
• Cabal二进制目录自动添加到PATH变量。

使用场景

1. 文档格式转换：支持Markdown、HTML、LaTeX等多种格式互转，适用于技术文档、内容创作的格式转换需求；
2. 轻量级Wiki搭建：通过Gitit快速搭建团队或个人知识库，基于Git实现版本控制。

配置说明

Pandoc使用

• 查看支持格式：运行容器无参数时默认输出pandoc --help

  bash
  docker run --rm marcelhuberfoo/pandoc-gitit
  

• 映射数据卷转换文件（示例：Markdown转HTML5）：

  bash
  docker run -v /tmp/my-data:/data marcelhuberfoo/pandoc-gitit pandoc -f markdown -t html5 myfile.md -o myfile.html
  

Gitit使用

首次搭建（无现有Wiki）

bash
docker run -d --name gitit \
  -e GIT_COMMITTER_NAME="你的姓名" \
  -e GIT_COMMITTER_EMAIL="你的邮箱" \
  -p 60000:5001 \
  marcelhuberfoo/pandoc-gitit \
  gitit -f /data/gitit.conf

访问http://localhost:60000即可使用Wiki。必须传递提交者姓名和***，否则容器会因Git提交错误终止。

使用现有Wiki

假设现有Wiki路径为/home/gitit/wiki：

bash
docker run -d --name gitit \
  -e GIT_COMMITTER_NAME="你的姓名" \
  -e GIT_COMMITTER_EMAIL="你的邮箱" \
  -p 60000:5001 \
  -v /home/gitit/wiki:/data \
  marcelhuberfoo/pandoc-gitit \
  gitit -f /data/gitit.conf

文件与端口

• data/gitit.conf：Gitit配置文件（未提供则自动生成默认配置）；
• 自动生成文件夹：/data/static（静态资源）、/data/templates（页面模板）、/data/wikidata（Git仓库）；
• 暴露端口：5001（Gitit默认Web端口）。

权限设置

容器内使用docky用户（UID/GID均为654321）运行程序，映射/data卷时需确保主机文件夹权限：

1. 创建组和用户：

   bash
   groupadd -g 654321 docky
   useradd --system --uid 654321 --gid docky --shell '/sbin/nologin' docky
   

2. 将自己加入组：

   bash
   gpasswd --add 你的用户名 docky
   

3. 设置文件夹权限：

   bash
   chmod -R g+w /tmp/my-data
   chgrp -R docky /tmp/my-data