gitage 正在参加 2021 年度 OSC 中国开源项目评选,请投票支持!
gitage 在 2021 年度 OSC 中国开源项目评选 中已获得 {{ projectVoteCount }} 票,请投票支持!
2021 年度 OSC 中国开源项目评选 正在火热进行中,快来投票支持你喜欢的开源项目!
2021 年度 OSC 中国开源项目评选 >>> 中场回顾
gitage 获得 2021 年度 OSC 中国开源项目评选「最佳人气项目」 !
授权协议 MIT
开发语言 JavaScript
操作系统 跨平台
软件类型 开源软件
开源组织
地区 国产
投 递 者 hyjiacan
适用人群 未知
收录时间 2020-11-19

软件简介

gitage

基于 NodeJS 的 git-pages 静态 WEB服务

依赖:

  • git
  • nodejs>8

目前支持的托管系统:

概述

gitage 运行在 nodejs 上,依赖 git (gitea, gogs, gitlab) 等托管系统的 web 勾子。

gitage 主要为团队/公司等非公开组织提供一个易于部署的 pages 服务。

gitage 提供 markdown 文件渲染,以及 一些类型 文件的预览支持。

用法

首次运行,需要执行命令 npm run download 下载依赖的第三方包。

npm run build
node dist/gitage.js

服务器配置

配置文件名为 config (区分大小写),放置在部署根目录。

config

# 是否启用调试
DEBUG = false
# 启动服务的IP地址
HOST = 0.0.0.0
# 启动服务的端口
PORT = 1997
# 日志路径,可以指定为绝对路径或相对路径
LOG_PATH = logs
# 日志记录的级别
LOG_LEVEL = info
# 仓库部署路径,可以指定为绝对路径或相对路径
PROJECT_ROOT_PATH = projects
# 仓库检出临时目录,留空使用系统临时目录
PROJECT_CHECKOUT_TMP = 

在无此文件时,使用以上默认配置

注意:配置项名称均使用大写

仓库配置

在仓库下添加文件 gitage.config.json,其格式如下(可选):

{
  "type": "markdown",
  "path": "docs",
  "index": "index.html",
  "tag": true,
  "branch": "master",
  "ignore": [
    "file",
    "dir",
    "..."
  ]
}
  • type 标记部署内容的类型,目前仅支持 markdown,表示内容为 markdown,否则直接留空 区分大小写
  • path 部署目录,默认为 docs
  • index 部署目录下的索引页名称,默认为 index.html/index.md 区分大小写
  • tag 是否仅在收到 tag 时部署,默认为 false (计划中)
  • branch 指定部署的分支,默认为 master (配置文件应该存放在主分支上,以避免无法正常读取)

在仓库的 web hook 上添加地址:

POST http://127.0.0.1:1997/hook/

127.0.0.1 是部署的服务器IP 1997 是部署的端口

type-markdown

当 type=markdown 时,可以在仓库内指定一个目录 (可以是仓库根目录 /),用于发布文档文件。

在此模式下,会扫描整个部署目录,并自动生成文档树。 每个文件都包含其最后更新的用户/日期以及更新消息。

目前支持 .md|.markdown|.txt|.pdf|.docx 类型文件在线查看。

截图

1

2

 

展开阅读全文

代码

的 Gitee 指数为
超过 的项目

评论 (4)

加载中
不是基于git吗,怎么又搞成node了?
2021/02/07 08:56
回复
举报
hyjiacan软件作者
git 也不提供 http 服务啊,node 是用来提供 http 服务的
2021/03/02 11:12
回复
举报
所以说应该是基于Node.js呀
2021/03/03 11:58
回复
举报
hyjiacan软件作者
是这么说的么 ? 那我改
2021/03/05 09:29
回复
举报
更多评论
发表了资讯
2021/02/06 16:14

gitage 0.6.0 已经发布,基于 GIT 的静态 WEB 服务

gitage 0.6.0 已经发布,这是一个基于 GIT 的静态 WEB 服务。 此版本更新内容包括: 修复 在 git 仓库的服务器地址改变后,无法正确拉取代码的问题 从仓库中移除第三方依赖,改为静态资源模式 优化 文件处理器支持 优化 50x 页面的显示 优化 git 消息执行 trim 优化 hook 工作流程 优化 markdown 界面 优化 当未指定分支时,只接收 master 分支的推送 优化 文本文件的展示 优化 模板输出 优化 渲染markdown时,图片宽度最大允许...

0
4
没有更多内容
加载失败,请刷新页面
点击加载更多
加载中
下一页
暂无内容
暂无内容
4 评论
8 收藏
分享
OSCHINA
登录后可查看更多优质内容
返回顶部
顶部