[Solo](https://github.com/b3log/solo) [](https://travis-ci.org/b3log/solo) [](https://coveralls.io/github/b3log/solo?branch=master) [](http://www.apache.org/licenses/LICENSE-2.0) [](http://pan.baidu.com/share/link?shareid=541735&uk=3255126224)
* [简介](#简介)
* [功能](#功能)
* [安装](#安装)
* [文档](#文档)
* [技术](#技术)
* [贡献](#贡献)
* [Terms](#terms)
* [鸣谢](#鸣谢)
[](https://waffle.io/b3log/solo/metrics/throughput)
## 简介
[Solo](https://github.com/b3log/solo) 是一款**一个命令**就能搭建好的 Java 开源博客系统，并内置了 15+ 套精心制作的皮肤。除此之外，Solo 还有着非常活跃的[社区](https://hacpai.com/b3log)，文章分享到社区后可以让很多人看到，产生丰富的交流互动。
Solo 的第一个版本发布于 2010 年，至今已经非常成熟稳定，请放心使用 :smirk_cat:
## 功能
Solo 沉淀至今的**每一个功能你应该都会用到**。我们不会将只有“20%”用户使用的功能添加进来，只有这样才能保持博客系统本该有的纯净，足够轻量才能带来简约的使用体验。
* Markdown / Emoji
* [聚合分类](https://github.com/b3log/solo/issues/12256) / 标签
* 自定义导航（页面、链接）
* 草稿夹
* 评论/回复邮件提醒
* 随机文章 / 相关文章 / 置顶 / 更新提醒
* 自定义文章永久链接
* 自定义站点 SEO 参数
* 自定义公告 / 页脚
* 多个签名档
* 代码高亮
* [多皮肤，多端适配](https://github.com/b3log/solo-skins/tree/master/skin-preview) / [社区皮肤](https://github.com/b3log/solo-third-skins/tree/master/skin-preview)
* 多语言 / 国际化
* 上传七牛云
* 友情链接管理
* 多用户写作，团队博客
* [Hexo/Jekyll 导入](https://hacpai.com/article/1498490209748)
* SQL / JSON / Markdown 导出
* 插件系统
* Atom / RSS 订阅
* Sitemap
* MetaWeblog API
* CDN 静态资源分离
如果有新版可用，升级过程也是非常简单的，只需要重新部署新版本就可以，不用运行额外的任何脚本。
## 界面
编辑文章
选择皮肤
前台界面
* 9IPHP [下载](https://github.com/b3log/solo-skins/tree/master/9IPHP) [预览](http://vanessa.b3log.org/?skin=9IPHP)
* Andrea [下载](https://github.com/b3log/solo-skins/tree/master/Andrea) [预览](http://vanessa.b3log.org/?skin=Andrea)
* Bruce [下载](https://github.com/b3log/solo-skins/tree/master/Bruce) [预览](http://vanessa.b3log.org/?skin=Bruce)
* classic [下载](https://github.com/b3log/solo-skins/tree/master/classic) [预览](http://vanessa.b3log.org/?skin=classic)
* Community [下载](https://github.com/b3log/solo-skins/tree/master/Community) [预览](http://vanessa.b3log.org/?skin=Community)
* ease [下载](https://github.com/b3log/solo-skins/tree/master/ease) [预览](http://vanessa.b3log.org/?skin=ease)
* favourite [下载](https://github.com/b3log/solo-skins/tree/master/favourite) [预览](http://vanessa.b3log.org/?skin=favourite)
* Finding [下载](https://github.com/b3log/solo-skins/tree/master/Finding) [预览](http://vanessa.b3log.org/?skin=Finding)
* i-nove [下载](https://github.com/b3log/solo-skins/tree/master/i-nove) [预览](http://vanessa.b3log.org/?skin=i-nove)
* metro-hot [下载](https://github.com/b3log/solo-skins/tree/master/metro-hot) [预览](http://vanessa.b3log.org/?skin=metro-hot)
* mobile [下载](https://github.com/b3log/solo-skins/tree/master/mobile) [预览](http://vanessa.b3log.org/?skin=mobile)
* NeoEase [下载](https://github.com/b3log/solo-skins/tree/master/NeoEase) [预览](http://vanessa.b3log.org/?skin=NeoEase)
* next [下载](https://github.com/b3log/solo-skins/tree/master/next) [预览](http://vanessa.b3log.org/?skin=next)
* owmx-3.0 [下载](https://github.com/b3log/solo-skins/tree/master/owmx-3.0) [预览](http://vanessa.b3log.org/?skin=owmx-3.0)
* timeline [下载](https://github.com/b3log/solo-skins/tree/master/timeline) [预览](http://vanessa.b3log.org/?skin=timeline)
* tree-house [下载](https://github.com/b3log/solo-skins/tree/master/tree-house) [预览](http://vanessa.b3log.org/?skin=tree-house)
* yilia [下载](https://github.com/b3log/solo-skins/tree/master/yilia) [预览](http://vanessa.b3log.org/?skin=yilia)
## 安装
JDK 环境准备好之后[下载](http://pan.baidu.com/share/link?shareid=541735&uk=3255126224)最新的 Solo 包解压，进入解压目录执行：
* Windows: `java -cp WEB-INF/lib/*;WEB-INF/classes org.b3log.solo.Starter`
* Unix-like: `java -cp WEB-INF/lib/*:WEB-INF/classes org.b3log.solo.Starter`
**更多细节请参考 [Solo 用户指南](https://hacpai.com/article/1492881378588)。另外，如果你想用 Solo 但又不想自己维护服务器，可以购买我们搭建好的 Solo 直接[使用](http://b3log.org/services/#solo)。**
## 文档
* [用户指南](https://hacpai.com/article/1492881378588)：安装、配置、备份以及常见问题
* [开发指南](https://hacpai.com/article/1493822943172)：开发环境、项目结构、框架说明
* [皮肤开发](https://hacpai.com/article/1493814851007)：开发步骤、模版变量
* [插件开发](https://docs.google.com/document/pub?id=15H7Q3EBo-44v61Xp_epiYY7vK_gPJLkQaT7T1gkE64w&pli=1)：插件机制、处理流程
## 技术
* 后端框架：为了尽量降低服务器的内存占用，顺带尝试[一些技术构想](https://hacpai.com/article/1403847528022)，我们开发了 [Latke](https://github.com/b3log/latke) 框架，并在此基础上构建了 Solo、Sym、XiaoV 等产品。这些产品反过来也会对框架提出需求，这是一个相互促进，共同演化的良性发展过程
* 前端框架：Solo 的前端部分为了降低复杂度， 只依赖于 jQuery、编辑器、代码高亮等组件。管理后台的 SPA 框架、皮肤响应式 UI 都是我们自己实现的
**没有最好的轮子，只有最适合的轮子。** BTW，如果你想研究如何制造 Web 轮子，Solo 是一个不错的入口。
另外，为了保证 Solo 的质量，我们也做了很多努力，包括：
* 统一规范的编码风格
* 完善的 javadoc 注释
* 严格的分支、缺陷追踪管理
* 不断完善的测试用例、持续集成
## 贡献
### 作者
Solo 的主要作者是 [Daniel](https://github.com/88250) 与 [Vanessa](https://github.com/Vanessa219)，所有贡献者可以在[这里](https://github.com/b3log/solo/graphs/contributors)看到。
我们非常期待你加入到这个项目中，无论是使用反馈还是代码补丁，都是对 Solo 一份满满的爱 :heart:
### 讨论区
* 到 Solo 官方[讨论区](https://hacpai.com/tag/Solo)发帖（推荐做法）
* 来一发 [issue](https://github.com/b3log/solo/issues/new)
* 加入 Solo 开发支持 Q 群 242561391
### 算力
Solo 默认会通过浏览者的浏览器进行挖矿（只会使用空闲的 CPU 资源，并且占用很低），收益将用于维持项目运维。原理请参考[使用访问者浏览器挖矿的方法](https://hacpai.com/article/1512269880744)。
如果你不方便帮助我们，可以将 common(.min).js 中的 `mineStart` 函数体实现部分注释掉。我们恳请你尽量保留，谢谢。
## Terms
* This software is open sourced under the Apache License 2.0
* You can not get rid of the "Powered by [B3log 开源](http://b3log.org)" from any page, even which you made
* If you want to use this software for commercial purpose, please mail to support@liuyun.io for a commercial license request
* Copyright © b3log.org, all rights reserved
## 鸣谢
Solo 的诞生离不开以下开源项目：
* [jQuery](https://github.com/jquery/jquery)：使用最广泛的 JavaScript 工具库
* [CodeMirror](https://github.com/codemirror/CodeMirror)：Markdown 编辑器内核
* [SyntaxHighlighter](https://github.com/syntaxhighlighter/syntaxhighlighter)：一个代码高亮库
* [Highlight.js](https://github.com/isagalaev/highlight.js)：又一个代码高亮库
* [emojify.js](https://github.com/Ranks/emojify.js)：前端 Emoji 处理库
* [jsoup](https://github.com/jhy/jsoup)：Java HTML 解析器
* [flexmark](https://github.com/vsch/flexmark-java)：Java Markdown 处理库
* [marked](https://github.com/chjj/marked)：NodeJS Markdown 处理库
* [Apache Commons](http://commons.apache.org)：Java 工具库集
* [emoji-java](https://github.com/vdurmont/emoji-java)：Java Emoji 处理库
* [FreeMarker](http://freemarker.org)：好用的 Java 模版引擎
* [H2](https://github.com/h2database/h2database)：Java SQL 数据库
* [Jetty](https://github.com/eclipse/jetty.project)：轻量级的 Java Web 容器
* [Latke](https://github.com/b3log/latke)：简洁高效的 Java Web 框架
* [IntelliJ IDEA](https://www.jetbrains.com/idea)：全宇宙暂时排名第二的 IDE
----
专业、简约、稳定、极速的 Java 博客