Giter Club home page Giter Club logo

symphony's Introduction

简介

Sym 是一个用 Java 写的实时论坛,欢迎来体验

如果你需要搭建一个企业内网论坛,请使用 SymX

作者

Sym 的主要作者是 DanielVanessa,所有贡献者可以在这里看到。

初衷

Sym 的诞生是有如下几点原因:

  • 已有的用 Java 写的论坛很少也很丑,并且大多数已经不再维护
  • 我们想实现一种新的网络社区体验,独立博客+论坛互动

基本理念

实时交互

在浏览帖子时,传统论坛都是需要刷新页面来查看回帖的,而 Sym 则是基于 WebSocket 技术进行回帖推送,看帖时不需要刷新页面也可以看到其他人回帖。

互联

Sym 提供了 API 进行帖子、评论的同步(B3log 构思),目前 SoloTypechoZ-BlogPHPWordPress 均已经提供插件来进行内容同步,欢迎大家进行接入!

HTML5

Sym 使用了很多 HTML5 提供的技术特性,比如

  • 通过使用本地存储防止编辑帖子/评论时内容丢失
  • 使用了音频特性来进行帖子/评论音频录制、播放
  • 复制/粘贴上传图片
  • CSS3 动画

通过使用这些技术,Sym 可以让用户在分享、交流时更加便捷、舒服

功能图解

首页

首页

帖子

帖子

个人设置

个人设置

发布编辑

  • Markdown 编辑器,支持 GFM 语法
  • LaTeX 数学公式
  • 复制粘贴时自动转换为 Markdown
  • Chrome 下可以直接粘贴图片,其他浏览器支持拖拽
  • 除了使用文字,也可以在帖子内进行录音
  • 支持 Emoji
  • 使用本地存储保障数据在未提交时不丢

发布编辑

移动端

移动端使用单独的模版进行渲染,解决通过一套模版自适应不能达成的效果和体验。

安装

需求:Maven3+、MySQL5+、Jetty9+/Tomcat9+(理论上只要实现了 JSR356 规范的 Servlet 容器都可以)

  1. 下载源码
  2. 解压后修改 src/main/resources/local.properties 中的数据库配置,并创建数据库
  3. _可能需要_修改 latke.properties 中的端口为容器端口
  4. _可能需要_修改 init.properties 中的管理员账号
  5. 使用 mvn install 进行构建
  6. 部署到 Servlet 容器的 ROOT 下并启动容器,数据库表会在第一次启动时自动建立

注意:

  • 没有数据库建表 SQL 脚本,只需要手动建库,表会在第一次启动时自动生成
  • 只能部署到 ROOT 中,线上环境建议使用反向代理
  • Tomcat 用 9 以上版本,最好是使用最新版

配置

  • 图片上传默认是上传服务器本地,要使用七牛可配置 symphony.properties 中的 qiniu.* 属性
  • 邮件发送使用的是 SendCloud,需要配置 symphony.properties 中的 sendcloud.* 属性
  • 将 WEB-INF/cron.xml 中注释掉的部分打开
  • 如果部署在 Jetty 容器中,需要把 WEB-INF/web.xml 中如下配置注释掉:
  <servlet>
      <servlet-name>default</servlet-name>
      <servlet-class>org.eclipse.jetty.servlet.DefaultServlet</servlet-class>
      <init-param>
          <param-name>useFileMappedBuffer</param-name>
          <param-value>false</param-value>
      </init-param>
  </servlet>

用户注册时是启用邮件验证的,如果需要修改请参考相关代码。

注意:

本地配置完成部署后,还需要对七牛(如果使用了)和 SendCloud 进行服务配置:

  • 配置_两个_七牛图片数据处理样式: qiniu
  • 配置 SendCloud 邮件模版: sendcloud

如果遇到问题,可以参考一下这篇帖子

商用授权

请看这里

思绪

在实现 B3log 构思的这几年:

  • 我们见证了 xAE(GAE/BAE/SAE/etc)的兴起与没落。2009 年选择了 GAE 作为服务器,并开始实现 Latke 框架来解决跨云平台,直到告别 GAE,不得不感叹技术更迭之快
  • 感受到了自造轮子的优缺点,并且可以肯定一点:对于一个想要长久的产品来说,自制技术框架优势远大于劣势
  • 一个好玩的产品或说是细节特性然并卵,需要做的是一个能够持续提供用户价值的产品/特性
  • 虽然直到目前 B3log 系产品用户不多,但我们已经初步证明了:Java 用来实现博客、论坛没有什么不好的
  • 使用开源软件,了解开源**,融入开源

Terms

  • This software is open sourced under the Apache License 2.0
  • You can not get rid of the "Powered by B3log 开源Sym" from any page, even which you made
  • If you want to use this software for commercial purpose, please mail to [email protected] for a commercial license request
  • Copyright © b3log.org, all rights reserved

symphony's People

Contributors

88250 avatar vanessa219 avatar dongxuwang avatar wangdx avatar mainlove avatar

Watchers

 avatar James Cloos avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.