Lute HTTP 使用指南

本贴最后更新于 1624 天前,其中的信息可能已经时过境迁

简介

Lute HTTP 包装 Lute 以 HTTP 发布服务。

背景

该项目主要是为了:

  • 让不同编程语言编写的应用能够复用标准的(符合 GFM/CommonMark)Markdown 渲染
  • 为 Sym、Solo 提供更好的 Markdown 渲染,解决各项目内建的 Markdown 渲染不统一的问题

使用

可通过如下任意一种方式使用 Lute HTTP,建议通过 Docker 使用,方便运维。

  • Docker
    1. 获取最新镜像 docker pull b3log/lute-http
    2. 启动容器 docker run --detach --rm --network=host b3log/lute-http
  • 可执行文件
    1. 安装 golang,然后获取并编译 go get -u github.com/88250/lute-http
    2. 编译成功后将在 ${GOPATH}/bin 下生成名为 lute-http 的可执行文件
    3. 需要通过 nohup& 让进程在后台运行: nohup ./lute-http > lute-http.log 2>&1 &

按如上之一方式启动 lute-http 后再带参 --lute_http=http://localhost:8249 启动 Solo、Sym 即可。

授权

Lute HTTP 使用 木兰宽松许可证, 第 2 版 开源协议。

鸣谢

  • Lute:一款结构化的 Markdown 引擎,支持 Go 和 JavaScript
  • fasthttp:用 golang 写的高性能 HTTP 实现
  • Gulu:Go 语言常用工具库
3 操作
88250 在 2020-07-08 14:11:19 更新了该帖
88250 在 2020-01-24 00:21:03 更新了该帖
88250 在 2019-11-18 11:11:20 更新了该帖

相关帖子

优质回帖
  • 88250 1

    建议尽量使用 Lute 来渲染 Markdown,效果拔群 😅

  • 88250 1

    Solo 的参数 --lute_http=http://IP:8249 IP 地址如果是宿主机网络的话写 127.0.0.1。

  • CodingOX 1 1 赞同

    搞定了,因为 network 不是 localhost,所以需要通过容器名来做访问映射。

    1. lute 的启动命令修改为:
    docker run --detach --rm --network=tencent --name lute b3log/lute-http
    
    1. 然后通过自定义的名字 lute 进行容器间的访问
    --lute_http=http://lute:8249
    

欢迎来到这里!

我们正在构建一个小众社区,大家在这里相互信任,以平等 • 自由 • 奔放的价值观进行分享交流。最终,希望大家能够找到与自己志同道合的伙伴,共同成长。

注册 关于
请输入回帖内容 ...
  • 请教一下,我运行起来后,具体怎么使用呢?有 API 文档吗?

  • 其他回帖
  • CodingOX

    刚看了下日志,提示报错:

    Failed to use Lute [http://localhost:8249] for markdown [md=![](https://b3logfile.com/bing/20200206.jpg?imageView2/1/w/960/h/540/interlace/1/q/100)
    
    1 回复
  • PhzCode

    docker restart b3log/solo --lute_http=http://localhost:8249,然后提示 unknown flag: --lute_http,不是直接 restart 吗 😭

    1 回复
  • 查看全部回帖