gitage

基于 GIT 的静态 WEB 服务
授权协议 MIT
开发语言 JavaScript
所属分类 Web应用开发、 WEB服务/SOAP/SOA
软件类型 开源软件
地区 国产
投 递 者 颛孙高义
操作系统 跨平台
开源组织
适用人群 未知
 软件概览

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

 

 相关资料
  • 有人能回答我的困境,使用哪种方法将Android设备连接到mySQL或PostgreSQL? 我可以用这两种方式来做,没有任何错误和问题,没有明显的区别,但每个人都建议使用web服务而不是使用jdbc驱动程序和直接连接,

  • 问题内容: 我的要求是,我应该通过一个安静的服务将10MB的zip文件发送给客户端。我在论坛中找到了发送对象是更好的方法的代码,但是如何在以下代码中创建对象: 问题答案: 它是下载文件的更好方法和简便方法。 对于您所要求的代码:

  • StaticCache 静态变量形式的缓存(是存放于当前进程的内存中)。注册中心的服务地址也存放于静态缓存中。 StaticCache::set($key, $value, $canUnset = true) use StaticCache; StaticCache::set('foo', 'bar'); //默认该变量可以被释放,也可设置不释放。使用情况:在使用Async

  • 问题内容: 我正在尝试在nodejs中创建静态文件服务器,而不是将其作为完美的服务器,这更多是为了理解节点。我非常了解Connect和node- static之类的项目,并且完全打算将这些库用于更多可用于生产的代码,但我也想了解我正在使用的基础知识。考虑到这一点,我编写了一个小的server.js: 我的问题是双重的 这是在节点中创建和流式传输基本html等的“正确”方法,还是有更好/更优雅/更可

  • 使用Spring Boot web应用程序,我试图从项目外部的文件系统文件夹中为静态资源提供服务。 文件夹结构类似于:- Spring配置:- 在我的浏览器中点击“http://localhost:9999/test/test.js”返回404。 提供绝对文件路径有效:- 如何提供相对位置?绝对路径将使我的生活在构建和部署过程中变得艰难。

  • 有时候希望人工管理服务提供者的上线和下线,此时需将注册中心标识为非动态管理模式。 <dubbo:registry address="10.20.141.150:9090" dynamic="false" /> 或者 <dubbo:registry address="10.20.141.150:9090?dynamic=false" /> 服务提供者初次注册时为禁用状态,需人工启用。断线时,将不