Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/gitalk/gitalk

Gitalk is a modern comment component based on Github Issue and Preact.
https://github.com/gitalk/gitalk

comment github github-issues plugin preact react

Last synced: 2 days ago
JSON representation

Gitalk is a modern comment component based on Github Issue and Preact.

Awesome Lists containing this project

README 

        
# Gitalk



[![NPM][npm-version-image]][npm-version-url] 

[![CDNJS][cdnjs-version-image]][cdnjs-version-url] 

[![jsdelivr](https://data.jsdelivr.com/v1/package/npm/gitalk/badge)](https://www.jsdelivr.com/package/npm/gitalk)

[![david-dm][david-dm-image]][david-dm-url] 

[![travis][travis-image]][travis-url] 

[![coveralls][coveralls-image]][coveralls-url] 

[![gzip-size][gzip-size]][gzip-url]



Gitalk 是一个基于 GitHub Issue 和 Preact 开发的评论插件。



## 特性



- 使用 GitHub 登录

- 支持多语言 [en, zh-CN, zh-TW, es-ES, fr, ru, de, pl, ko, fa, ja]

- 支持个人或组织

- 无干扰模式（设置 distractionFreeMode 为 true 开启）

- 快捷键提交评论 （cmd|ctrl + enter）



[Readme](https://github.com/gitalk/gitalk/blob/master/readme.md)

[在线示例](https://gitalk.github.io)



## 安装



两种方式



- 直接引入



```html

  

  



  



  

  

```



- npm 安装



```sh

npm i --save gitalk

```



```js

import 'gitalk/dist/gitalk.css'

import Gitalk from 'gitalk'

```



## 使用



首先，您需要选择一个公共github存储库（已存在或创建一个新的github存储库）用于存储评论，



然后需要创建 **GitHub Application**，如果没有 [点击这里申请](https://github.com/settings/applications/new)，`Authorization callback URL` 填写当前使用插件页面的域名。



最后, 您可以选择如下的其中一种方式应用到页面：



### 方式1



添加一个容器：



```html



```



用下面的 Javascript 代码来生成 gitalk 插件：



```js

var gitalk = new Gitalk({

  clientID: 'GitHub Application Client ID',

  clientSecret: 'GitHub Application Client Secret',

  repo: 'GitHub repo',

  owner: 'GitHub repo owner',

  admin: ['GitHub repo owner and collaborators, only these guys can initialize github issues'],

  id: location.pathname,      // Ensure uniqueness and length less than 50

  distractionFreeMode: false  // Facebook-like distraction free mode

})



gitalk.render('gitalk-container')

```



### 方式2：在React使用



使用以下代码引入Gitalk组件



```jsx

import GitalkComponent from "gitalk/dist/gitalk-component";

```



按以下方式在React中使用Gitalk组件



```jsx



```



## 设置



- **clientID** `String` 



  **必须**. GitHub Application Client ID.



- **clientSecret** `String` 



  **必须**. GitHub Application Client Secret.



- **repo** `String` 



  **必须**. GitHub repository.



- **owner** `String` 



  **必须**. GitHub repository 所有者，可以是个人或者组织。



- **admin** `Array` 



  **必须**. GitHub repository 的所有者和合作者 (对这个 repository 有写权限的用户)。



- **id** `String` 

  

  Default: `location.href`.



  页面的唯一标识。长度必须小于50。

  

- **number** `Number` 

  

  Default: `-1`.



  页面的 issue ID 标识，若未定义`number`属性则会使用`id`进行定位。



  提示：可以使用正则从 `URL` 中提取其中一部份作为 `id`。例如：`location.href.match('/(?<=posts/)(.*)(?=/)/')[1]`



- **labels** `Array` 

  

  Default: `['Gitalk']`.



  GitHub issue 的标签。



- **title** `String` 

  

  Default: `document.title`.



  GitHub issue 的标题。



- **body** `String` 

  

  Default: `location.href + header.meta[description]`.



  GitHub issue 的内容。



- **language** `String` 

  

  Default: `navigator.language || navigator.userLanguage`.



  设置语言，支持 [en, zh-CN, zh-TW, es-ES, fr, ru, de, pl, ko, fa, ja]。



- **perPage** `Number` 

  

  Default: `10`.



  每次加载的数据大小，最多 100。



- **distractionFreeMode** `Boolean` 

  

  Default: false。



  类似Facebook评论框的全屏遮罩效果.



- **pagerDirection** `String`



  Default: 'last'



  评论排序方式， `last`为按评论创建时间倒叙，`first`为按创建时间正序。



- **createIssueManually** `Boolean` 

  

  Default: `false`.



  如果当前页面没有相应的 isssue 且登录的用户属于 admin，则会自动创建 issue。如果设置为 `true`，则显示一个初始化页面，创建 issue 需要点击 `init` 按钮。



- **proxy** `String` 



  Default: `https://cors-anywhere.azm.workers.dev/https://github.com/login/oauth/access_token`.



   GitHub oauth 请求到反向代理，为了支持 CORS。 [为什么要这样?](https://github.com/isaacs/github/issues/330)



- **flipMoveOptions** `Object` 

  

  Default:

  ```js

    {

      staggerDelayBy: 150,

      appearAnimation: 'accordionVertical',

      enterAnimation: 'accordionVertical',

      leaveAnimation: 'accordionVertical',

    }

  ```



  评论列表的动画。 [参考](https://github.com/joshwcomeau/react-flip-move/blob/master/documentation/enter_leave_animations.md)



- **enableHotKey** `Boolean` 

  

  Default: `true`.



  启用快捷键(cmd|ctrl + enter) 提交评论.



## 实例方法



- **render(String/HTMLElement)**



  初始化渲染并挂载插件。



## TypeScript



已经包括了配置项和Gitalk类的类型定义，不包括React组件的类型定义。



## 贡献



1. [Fork 代码仓库](https://github.com/gitalk/gitalk/fork) 并从 master 创建你的分支

2. 如果你添加的代码需要测试，请添加测试！

3. 如果你修改了 API，请更新文档。

4. 确保单元测试通过 (npm test).

5. 确保代码风格一致 (npm run lint).

6. 提交你的代码 (git commit) [提交信息格式参考](https://github.com/angular/angular.js/blob/master/CONTRIBUTING.md#-git-commit-guidelines)



## 类似项目



- [gitment](https://github.com/imsun/gitment)

- [vssue](https://vssue.js.org/zh)



## 许可



MIT



[npm-version-image]: https://img.shields.io/npm/v/gitalk.svg?style=flat-square

[npm-version-url]: https://www.npmjs.com/package/gitalk

[cdnjs-version-image]: https://img.shields.io/cdnjs/v/gitalk.svg?style=flat-square

[cdnjs-version-url]: https://cdnjs.com/libraries/gitalk

[david-dm-image]: https://david-dm.org/gitalk/gitalk.svg?style=flat-square

[david-dm-url]: https://david-dm.org/gitalk/gitalk

[travis-image]: https://img.shields.io/travis/gitalk/gitalk/master.svg?style=flat-square

[travis-url]: https://travis-ci.org/gitalk/gitalk

[coveralls-image]: https://img.shields.io/coveralls/gitalk/gitalk/master.svg?style=flat-square

[coveralls-url]: https://coveralls.io/github/gitalk/gitalk

[gzip-size]: https://img.badgesize.io/https://unpkg.com/gitalk/dist/gitalk.min.js?compression=gzip&style=flat-square

[gzip-url]: https://unpkg.com/gitalk/dist/gitalk.min.js