|
1 |
| -# m2m |
| 1 | +# M2M |
2 | 2 |
|
3 | 3 | > Markdown to More
|
4 | 4 |
|
5 |
| -将Markdown转换为其它格式的内容,如一个博客,一个网站,或者是一封邮件 |
6 |
| - |
7 |
| -它还能将你的博客或网站自动提交到git,或者发布到你的服务器上。也可以通过简单的命令将最近的Markdown作为邮件发送,并将邮件中的图片插入到邮件中。 |
| 5 | +将Markdown转换博客、网站,也可以生成一封HTML格式的邮件并发送。它还能将你的博客或网站自动提交到git,或者发布到你的服务器上。 |
8 | 6 |
|
9 | 7 | ## 如何安装
|
10 | 8 |
|
11 |
| -* 请确认你的电脑上已经安装了`ruby`环境,`Mac OSX`系统已经自带`Ruby`环境,Windows系统,请移步Ruby官方网站进行安装:https://www.ruby-lang.org/zh_cn/downloads/ |
12 |
| -* 打开命令行,执行`sudo gem install m2m`即可安装 |
13 |
| - |
14 |
| -## 配置文件 |
15 |
| - |
16 |
| -在你要生成的文件目录,创建一个`m2m.config`的文件,`m2m.config`是一个JSON格式的文件,格式如下: |
17 |
| - |
18 |
| - |
19 |
| - { |
20 |
| - "blog":{ |
21 |
| - "title": "m2m官方博客", |
22 |
| - "host": "https://github.com/wvv8oo/m2m/" |
23 |
| - }, |
24 |
| - "theme": "hyde", |
25 |
| - "target": "./site" |
26 |
| - } |
27 |
| - |
28 |
| -* `blog.title`:博客的标题 |
29 |
| -* `blog.host`:博客的网址 |
30 |
| -* `theme`:主题,目前仅提供一个主题 |
31 |
| -* `target`:生成的目的目录,如果不设置,则会生成到`~/.m2m/[project_name]` |
32 |
| - |
33 |
| -**很快m2m将会提供自动生成配置文件的功能** |
34 |
| - |
35 |
| -## 命令介绍 |
36 |
| - |
37 |
| -### m2m build |
38 |
| - |
39 |
| -将当前目录下的markdown生成博客,也可以使用别名`m2m`,`m2m build`提供多个参数: |
40 |
| - |
41 |
| -* `m2m --target`或`m2m -t`:指定生成的目标 |
42 |
| -* `m2m --source`或`m2m -s`:指定工作目录,默认为当前目录 |
43 |
| - |
44 |
| -### m2m mail |
45 |
| - |
46 |
| -m2m提供将最近改动的markdown发送到指定邮箱的功能,也可以指定发送某个Markdown文件,此功能提供给需要写周报的同学使用,你懂的。 |
47 |
| - |
48 |
| -你需要在`m2m.config`文件中增加如下配置: |
49 |
| - |
50 |
| - |
51 |
| - "mail": { |
52 |
| - "smtp": "SMTP的地址", |
53 |
| - "port": "端口,一般是25", |
54 |
| - "account": "你的帐号", |
55 |
| - "password": "密码", |
56 |
| - "ssl": false, |
57 |
| - "from": "发件人", |
58 |
| - "to": "收件人,多个以逗号为分隔", |
59 |
| - "format": "%Y-%m-%d", |
60 |
| - "subject": "邮件标题" |
61 |
| - } |
62 |
| - |
63 |
| -* 发件人可以用 `姓名 <[email protected]>`这种格式,注意姓名与邮件地址中间的空格,否则会造成发不出邮件的情况 |
64 |
| -* 邮件标题中,可以添加`$last_week`(上周)与`$now`(今天)两个占位符,发邮件时会自动替换 |
65 |
| -* `format`是邮件标题中时间占位符的格式化字符,默认为`%Y-%m-%d`,生成结果参考:`2016-06-04` |
66 |
| -* 给个邮件标题的设置例子吧:`部门-姓名(花名) $last_week ~ $now` |
67 |
| - |
68 |
| -`m2m mail`蛮多个参数: |
69 |
| - |
70 |
| -* `--subject`或`-s`:指定邮件主题,优先级高于`m2m.config`的设置 |
71 |
| -* `--markdown`或`-m`:指定相对于当前目录的markdown文件,适用于要发送指定的markdown文件,如果不指定,则会发送最近修改的markdown文件 |
72 |
| -* `--slient`:静默发送,如果指定了此参数,将不会让用户确认直接发送 |
73 |
| -* `--addressee`或`-a`:指定发件人,优先级高于`m2m.config`的设置 |
74 |
| - |
75 |
| -### 邮件件发收件人 |
76 |
| - |
77 |
| -你有三个地方可以配置邮件主题与收件人,优先级为:`markdown文件>命令行参数指定>m2m.config文件` |
78 |
| - |
79 |
| -在markdown文件中,你可以通过写入meta的方式来指定邮件主题以及收件人,书写的方式如下: |
80 |
| - |
81 |
| - <!-- |
82 |
| - subject: 我指定的邮件主题,也可以使用$last_week和$now两个变量 |
83 |
| - |
84 |
| - --> |
85 |
| - 这是你的markdown文件内容 |
| 9 | +`sudo gem install m2m --source http://mirrors.aliyun.com/rubygems/ -n /usr/local/bin` |
86 | 10 |
|
87 |
| -### m2m pdf(暂未提供) |
| 11 | +## 相关链接 |
88 | 12 |
|
89 |
| -m2m允许将指定的Markdown文件生成pdf |
| 13 | +* 安装帮助:http://m2m.wvv8oo.com/install.html |
| 14 | +* 生成网站:http://m2m.wvv8oo.com/markdown-to-site.html |
| 15 | +* 生成HTML邮件:http://m2m.wvv8oo.com/markdown-to-mail.html |
| 16 | +* 自定义模板:http://m2m.wvv8oo.com/custom-theme.html |
| 17 | +* 配置:http://m2m.wvv8oo.com/config.html |
| 18 | +* 关于M2M:http://m2m.wvv8oo.com/about.html |
0 commit comments