Skip to content

meolu/walden

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Jan 24, 2016
3041a95 · Jan 24, 2016

History

74 Commits
Sep 21, 2015
Oct 7, 2015
Sep 3, 2015
Oct 8, 2015
Nov 27, 2015
Jan 21, 2016
Nov 27, 2015
Nov 11, 2015
Oct 27, 2015
Nov 27, 2015
Aug 30, 2015
Nov 27, 2015
Sep 3, 2015
Oct 7, 2015

Repository files navigation

Walden 最适合东半球同学使用的文档框架

Build Status

或许是极人性化的一个文档管理框架,最适合部署在内网作为内网文档管理,url即目录层级。markdown+git+web搭配,让你一下子就喜欢上写文档分享。一分钟上手,有兴趣可挖掘隐藏技巧。

官网主页 | 体验Demo | 案例-瓦力-walle

演示

walden

特点

  • Markdown语法
  • 修改后实时展现,无编译
  • 多模板支持
  • 图片、附件上传,自动生成url
  • 多项目
  • 任意定义目录嵌套、定义文档,目录与文档均可中文(甚至推荐中文)
  • 文档、图片、附件同步保存至git,这下你安心了吧

一、安装

零安装、零配置,无数据库,不需要composer,开箱即用。只需要你有一台安装了git命令行,php5.3,nginx环境的linux机器。

二、快速开始

vi Config.php
return [
    // 项目留空保存文档和附件的git地址,可以是在github,好吧,不想公开,可以bitbucket。

    // 1.php进程的用户的id_rsa.pub已添加到git的ssh-key。这样才可以推送markdown下的文件。
    'git' => 'git@github.com:meolu/Walden-markdown-demo.git',

    // 2.好吧,如果实在不想加key,可以直接明文用户名密码认证的http(s)地址也可以。
    // 'git' => 'https://username:password@github.com/meolu/Walden-markdown-demo.git',
];

三、nginx简单配置

server {
    listen       80;
    server_name  Walden.dev;
    root /the/dir/of/Walden;
    index index.php;

    # 建议放内网做文档服务
    #allow 192.168.0.0/24;
    #deny all;

    location / {
        try_files $uri $uri/ /index.php$is_args$args;
    }

    location ~ \.php$ {
        try_files $uri =404;
        fastcgi_pass   127.0.0.1:9000;
        fastcgi_param  SCRIPT_FILENAME  $document_root$fastcgi_script_name;
        include        fastcgi_params;
    }
}

自定义模板

前端同学可以自己定义模板,在templates下新建一个模板目录,包含预览模板:markdown-detail-view.php,编辑模板:markdown-editor-view.php,然后修改Config.phptemplate为你的模板项目。

最后,当然希望你可以给此项目提个pull request,目前只有一个bootstrap的默认模板:(

to do list

  • 文档搜索
  • 文档删除,重命名UI化

CHANGELOG

瓦尔登的版本记录:CHANGELOG