wiki:MoinMoin

桌面版基本安装配置

下载参考:http://moinmo.in/MoinMoinDownload, 下载最新 stable 版本

安装参考解压后的 docs\INSTALL.html 文件

  • moinmoin 暂时只支持python2.7, 默认安装到 C:\Python27
  • 解压到文件夹:D:\installedSoftware\moin-1.9.11
  • 测试:命令行运行 C:\Python27\python.exe D:\installedSoftware\moin-1.9.11\wikiserver.py, 访问:http://localhost:8080/
  • 创建用户并配置 wikiconfig.py, 然后重启 wiki
class LocalConfig(multiconfig.DefaultConfig):
    # vvv DON'T TOUCH THIS EXCEPT IF YOU KNOW WHAT YOU DO vvv
    # Directory containing THIS wikiconfig:
    wikiconfig_dir = os.path.abspath(os.path.dirname(__file__))

    # self define
    superuser = [u"YourLoginName",]
    language_default='zh'

markdown 支持

参考:https://moinmo.in/ParserMarket/Markdown

安装库 markdown

c:\Python27\python.exe -m pip install --upgrade pip
c:\Python27\python.exe -m pip install markdown mdx-del-ins

下载 text_markdown.py 到 D:\installedSoftware\moin-1.9.11\wiki\data\plugin\parser, 该文件第一行加入 #coding=utf-8, 重启 wiki

测试一下,打开网址 http://localhost:8080/test 创建网页,内容

#format text_markdown

# 标题 1
## 标题 2
[链接](http://localhost:8080/)

自动添加 #format text_markdown: 编辑文件 MoinMoin\i18n\zh.MoinMoin.po

#, python-format
msgid "Describe %s here."
#msgstr " 在这里详述 %s。"
msgstr "#format text_markdown\n\n 在这里详述 %s。"

markdown 可用扩展,参考 https://python-markdown.github.io/extensions/, 配置扩展,编辑 text_markdown.py, 配置变量 output_html,并重启 wiki

    def format(self, formatter):
        # output_html = markdown(self.raw)
        output_html = markdown(self.raw,extensions=['extra', 'abbr', 'attr_list', 'def_list', 
                    'fenced_code', 'footnotes', 'tables',  'admonition', 'codehilite',
                    'legacy_attrs','legacy_em',  'meta', 'nl2br', 'sane_lists', 'smarty', 'toc',
                     'wikilinks'])

数学公式支持, 参考 https://pypi.org/project/python-markdown-math/

c:\Python27\python.exe -m pip install python-markdown-math

修改 wikiconfig.py,参考 https://www.mathjax.org/#gettingstarted 添加变量 html_head

    html_head = u"""
    <script async src="https://cdn.jsdelivr.net/npm/mathjax@3.0.5/es5/tex-svg.js"></script>
<script>
            MathJax = {
                tex:{inlineMath: [['$', '$'], ['\\(', '\\)']],
                    macros: {bf: '{\\boldsymbol f}',
                        bu: '{\\boldsymbol u}',
                        bv: '{\\boldsymbol v}',
                        bw: '{\\boldsymbol w}'
                    }
                },
                svg:{fontCache: 'global'}
            };
        </script>
                """

测试一下:

$$ 2*3 $$

$\sum_{i=0}^n$

其他设置

wikiconfig.py 首行修改为:# -*- coding: utf-8 -*-

配置导航和首页:

    # 导航
    navi_bar = [u'%(page_front_page)s', u'RecentChanges', u'FindPage', u'HelpContents',u" 关于 "]

    # 首页, 系统默认已经存在
    page_front_page = u" 首页 "

    # 权限
    acl_enabled = 1
    acl_rights_default = 'All:read' 
    acl_rights_before  = 'userName:read,write,admin,delete,revert'

帮助页面:http://localhost:8080/%E5%B8%AE%E5%8A%A9

安装,卸载 windows 服务

以管理员身份打开命令行安装服务:

sc create "MoinMoin" binPath="C:\Python27\python.exe D:\installedSoftware\moin-1.9.11\wikiserver.py" start= auto

windows 服务并不稳定,经常死掉。

卸载:sc delete moinmoin

评论(没有评论)