Skip to content

Commit

Permalink
Create comments and analytics posts
Browse files Browse the repository at this point in the history
  • Loading branch information
Rihoj authored and hossainemruz committed Mar 15, 2022
1 parent d169e62 commit a279d0e
Show file tree
Hide file tree
Showing 3 changed files with 81 additions and 3 deletions.
1 change: 0 additions & 1 deletion content/posts/analytics/hero.svg

This file was deleted.

81 changes: 80 additions & 1 deletion content/posts/comments/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,5 +8,84 @@ menu:
identifier: comments
weight: 650
---
## Comments

### Complete Post Coming Soon...
This theme has built-in support for comment on the posts. Currently, it support the following comment plugins:

- [Disqus](https://disqus.com/)
- [Valine](https://valine.js.org/)
- [Utterances](https://utteranc.es/)
- [Giscus](https://giscus.app/)

### Disqus

Disqus is a popular comment plug-in. After signing up to [Disqus](https://disqus.com/) you will need to provide your shortname under `params.features.comment` section of your `config.yaml` file as below:

```yaml
params:
features:
comment:
enable: true
disqus:
shortName: <your-disqus-shortname>
```
### Valine
[Valine](https://valine.js.org/) appears to be a Chinese comments comments plugin. You can enable valine comment plugin by adding `valine` section under `params.features.comments` section as below:

```yaml
params:
features:
comment:
enable: true
valine:
appId: app-id
appKey: app-key
avatar: avatar
placeholder: placeholder
lang: lang
recordIP: recordIP
enableQQ: enableQQ
```

### Utterances

Utterances uses [GitHub Issues](https://docs.github.com/en/issues/tracking-your-work-with-issues/about-issues) to store the comments for your posts. This requires you to allow have a public repository, and the Utterances app to use your repository. Setup instructions can be found at the [Utterances home page](https://utteranc.es/).

```yaml
params:
features:
comment:
enable: true
utteranc:
repo: your-repo/name
issueTerm: url
theme: light
```

### Giscus

Giscus is based off Utterances, but uses [GitHub Discussions](https://docs.github.com/en/discussions) as the backend. This requires you to allow have a public repository, and the Giscus app to use your repository. Setup instructions can be found at the [Giscus home page](https://giscus.app/).

To enable Giscus comment plugin, at first go to [giscus.app](https://giscus.app/). On the `Configuration` section, provide the necessary information. It will give you a script to include to your site. You just need to extract the respective information from the script and provide it under `params.features.comment.giscus` section as below:

```yaml
params:
features:
comment:
enable: true
giscus:
repo: your-repo/name
repoID: your-repo-id
category: your-category
categoryID: your-category-ID
# theme: light
# map: url
# reaction: 1
# metadata: 0
# inputPosition: bottom
# crossOrigin: anonymous
```

The commented out options are optional. You can use them to further customize your comment experience.
2 changes: 1 addition & 1 deletion themes/toha

0 comments on commit a279d0e

Please sign in to comment.