golang基于Dropbox的博客引擎插件boxed的使用

Golang基于Dropbox的博客引擎插件boxed的使用

[不再活跃]

Boxed

一个基于Dropbox的博客引擎

这个项目最初是作为一个博客即服务平台开始的，但很快成为了我的个人博客。它能完成工作，虽然不够美观和完善，但你可能觉得有用。它允许你在Dropbox文件夹中以markdown格式管理你的博客。

你可以在不安装任何东西的情况下在你的机器上运行它，所有内容都打包在可执行文件中（包括html和css），并将数据保存在一个bolt数据库中。性能也很好，我的个人博客是由一个树莓派在我糟糕的DSL路由器后面提供的。

尝试使用

如果你想尝试而不自己编译，你可以从alpha发布页面获取可执行文件。

你需要创建一个Dropbox应用并选择以下选项：

然后你需要相应地修改.env.sample文件，并在终端中：

# 设置环境变量
source .env.sample

# 将本地应用链接到Dropbox（按照说明操作）
./boxed --oauth

# 将一个markdown文件放入Dropbox目录中的published文件夹，并通过以下命令发布：
./boxed --refresh

# 运行服务器
./boxed

# 访问localhost:8080查看结果

如果你正确设置了webhook路径，你不需要刷新，当文章同步到你的Dropbox时它会被自动发布。

文章元数据

Boxed会尽力从markdown文章中找出发布日期和标题。如果这还不够，你可以通过markdown/json注释指定一些元数据，如下所示：


## 图片

Boxed开箱即用地支持图片，你需要将它们放在`images`文件夹中，然后像这样引用它们：`![cool image](../images/image.jpeg "Cool image")`

## 模板定制

Boxed自带优秀的默认hyde模板。如果你想改变它，就像我为我的博客所做的那样，你需要能够编译go代码，然后更改模板/css文件，然后使用go rice将它们重新打包到可执行文件中。

未来的版本将允许直接从Dropbox文件夹定制外观。

## 测试

你可以运行boxed测试：

```bash
go test ./...

许可证

这个项目是在简化BSD许可证下授权的。请阅读LICENSE文件。

TODO & 开发

  • 使入门更容易
  • 允许从Dropbox文件夹定制外观，而不需要代码编译
  • 为http流程添加测试
  • 使用SSE或websockets实现博客实时更新
  • 允许文章在未来发布

更多关于golang基于Dropbox的博客引擎插件boxed的使用的实战教程也可以访问 https://www.itying.com/category-94-b0.html

1 回复

更多关于golang基于Dropbox的博客引擎插件boxed的使用的实战系列教程也可以访问 https://www.itying.com/category-94-b0.html


使用Dropbox的Golang博客引擎插件boxed

boxed是一个基于Dropbox的Golang博客引擎插件，它允许你将Dropbox作为内容存储后端来构建静态博客。下面我将详细介绍如何使用boxed。

boxed简介

boxed的主要特点：

  • 使用Dropbox作为内容存储
  • 支持Markdown格式
  • 自动同步Dropbox中的内容变更
  • 轻量级且易于集成

安装boxed

首先安装boxed包：

go get github.com/asticode/go-boxed

基本使用示例

1. 初始化boxed客户端

package main

import (
	"fmt"
	"log"
	"github.com/asticode/go-boxed"
)

func main() {
	// 初始化boxed客户端
	client, err := boxed.New(boxed.Config{
		AccessToken: "your-dropbox-access-token",
	})
	if err != nil {
		log.Fatal(err)
	}
	
	// 后续操作...
}

2. 获取博客内容

// 获取指定路径下的所有文章
entries, err := client.List("/blog/posts")
if err != nil {
	log.Fatal(err)
}

for _, entry := range entries {
	fmt.Printf("文件名: %s\n", entry.Name)
	fmt.Printf("路径: %s\n", entry.Path)
	fmt.Printf("最后修改时间: %s\n", entry.Modified)
}

3. 读取文章内容

// 读取特定文章内容
content, err := client.Read("/blog/posts/hello-world.md")
if err != nil {
	log.Fatal(err)
}

fmt.Printf("文章内容:\n%s\n", content)

完整博客引擎示例

下面是一个更完整的示例，展示如何构建一个简单的博客引擎：

package main

import (
	"bytes"
	"fmt"
	"html/template"
	"log"
	"net/http"
	"strings"
	"time"
	
	"github.com/asticode/go-boxed"
	"github.com/russross/blackfriday/v2"
)

type Post struct {
	Title     string
	Content   template.HTML
	Date      time.Time
	Permalink string
}

var (
	client *boxed.Client
	tmpl   *template.Template
)

func init() {
	var err error
	
	// 初始化Dropbox客户端
	client, err = boxed.New(boxed.Config{
		AccessToken: "your-dropbox-access-token",
	})
	if err != nil {
		log.Fatal(err)
	}
	
	// 加载模板
	tmpl = template.Must(template.ParseGlob("templates/*.html"))
}

func main() {
	http.HandleFunc("/", indexHandler)
	http.HandleFunc("/post/", postHandler)
	
	fmt.Println("服务器启动在 :8080")
	log.Fatal(http.ListenAndServe(":8080", nil))
}

func indexHandler(w http.ResponseWriter, r *http.Request) {
	// 获取文章列表
	entries, err := client.List("/blog/posts")
	if err != nil {
		http.Error(w, err.Error(), http.StatusInternalServerError)
		return
	}
	
	// 解析文章
	var posts []Post
	for _, entry := range entries {
		if strings.HasSuffix(entry.Name, ".md") {
			content, err := client.Read(entry.Path)
			if err != nil {
				continue
			}
			
			// 转换Markdown为HTML
			html := blackfriday.Run([]byte(content))
			
			// 提取标题和日期
			title := strings.TrimSuffix(entry.Name, ".md")
			date := entry.Modified
			
			posts = append(posts, Post{
				Title:     title,
				Content:   template.HTML(html),
				Date:      date,
				Permalink: "/post/" + title,
			})
		}
	}
	
	// 渲染模板
	tmpl.ExecuteTemplate(w, "index.html", map[string]interface{}{
		"Posts": posts,
	})
}

func postHandler(w http.ResponseWriter, r *http.Request) {
	// 获取文章标题
	title := strings.TrimPrefix(r.URL.Path, "/post/")
	
	// 读取文章内容
	content, err := client.Read("/blog/posts/" + title + ".md")
	if err != nil {
		http.NotFound(w, r)
		return
	}
	
	// 转换Markdown为HTML
	html := blackfriday.Run([]byte(content))
	
	// 渲染模板
	tmpl.ExecuteTemplate(w, "post.html", Post{
		Title:   title,
		Content: template.HTML(html),
	})
}

获取Dropbox访问令牌

要使用boxed，你需要获取Dropbox访问令牌：

  1. 访问Dropbox开发者控制台：https://www.dropbox.com/developers/apps
  2. 创建新应用，选择"Dropbox API"
  3. 选择"App folder"权限
  4. 生成访问令牌

部署建议

  1. 将博客内容放在Dropbox的特定文件夹中（如/blog/posts）
  2. 使用Markdown格式编写文章
  3. 设置定期同步机制，自动获取最新内容
  4. 考虑添加缓存层提高性能

注意事项

  • 确保妥善保管Dropbox访问令牌
  • 考虑实现增量同步，避免每次请求都从Dropbox拉取数据
  • 对于生产环境，建议添加错误处理和日志记录
  • 注意Dropbox API的调用频率限制

boxed提供了一种简单的方式将Dropbox作为博客内容存储后端，特别适合个人博客或小型网站。通过结合Markdown和HTML模板，你可以快速构建一个功能完整的博客系统。

回到顶部