Speak开坑记录

项目说明

一个基于Gitee的“说说”，通过在gitee仓库中的issue进行说说的展示。项目灵感来自于：微博

开坑记录

项目最早写于2020年8月9日，但当时的做法是通过外部载入各种依赖（JQuery、marked等）进行的，虽然中间还有一次试图将其并入js内部，但采用的方式仅仅是通过jQuery的getScript方式，由于同时间所用Hexo博客主题作者更新了pjax，导致出现了一些出人意料地错误。直到9月20日，最终决定通过webpack打包，将其放在一起并放弃jQuery（为了减少体积）。
2021年3月22日，通过vue重构整个项目

3.x

预览地址： https://www.antmoe.com/speak/

关于数据源的几个问题：

为什么选择Gitee/GitHub作为数据源，而不是直接自建？
选择Gitee/GitHub等现有平台主要因为这样就不需要考虑写身份验证，防刷机制等问题。只需要考虑将其数据读取并存储即可。
为什么选择MongoDB，而不是MySQL？
首先是因为MongoDB官网提供免费的512m的存储，其次身为前端程序员，MySQL这种关系型数据库的玩法早已万光。
为什么将Gitee/GitHub数据存储到数据库而不是在线获取？
Gitee/GitHub的API在未认证的情况下每小时只可以请求60次（GitHub未验证），这60次包含任何请求，为了避开这个限制，只能将数据存储到其他数据库。
API怎么搭建？
api使用koa2，因此你可以自由选择部署到服务器亦或者是vercel。

3.3

由于vercel部分情况下过于龟速，因此添加了代理功能，目前试用CF进行代理。用户可以根据自身情况决定试用何种CDN代理。

ispeak3.3流程图

此浏览器插件修改自handsome时光机插件。

3.2

弃用爬虫项目，使用基于vercel部署的api服务获取数据。

3.1

改变3.0版本一次性加载全部数据为分批加载。

3.0

使用vue2.0重构项目，数据来源：爬虫项目爬取issue并发布到npm。

3.x之前

好像已经不能用了qwq

基本架构

为了方便使用，采用了类似jQuery的写法。

// 导入代码高亮模块
const hljs = require("./js/highlight.min");
// // 导入marked解析模块
const marked = require("./js/marked.min");
(function (window, undefiend) {
    let Speak = function (obj) {
        // 传入一个对象
        return new Speak.prototype.init(obj);
    };
    Speak.prototype = {
        constructor: Speak,
        init: function (obj) {
            for (let i in obj) {
                this[i] = obj[i];
            }
            // 调用初始化方法
            return this;
        },
    };
    Speak.extend = Speak.prototype.extend = function (obj) {
        for (var key in obj) {
            this[key] = obj[key];
        }
    };
    // 插入元素方法
    Speak.extend({
    });

    // 对象方法
    Speak.prototype.extend({
        s: 1,
    });

    Speak.prototype.init.prototype = Speak.prototype;

    window.Speak = Speak;
})(window);

其好处就是在使用时只需要实例化Speak对象即可完成一切。

第一个问题：原生JS发送异步请求

由于一开始的写法是获取与创建是分开写的，即获取后返回一个promise对象，通过then方法在将获取到的数据进行创建（渲染）。因此放弃jQuery的Ajax方法后也要返回一个Promise对象，这样才能以最小的成本兼容以前的写法。

参数_this调用时传入this

getSpeak: function (_this) {
    return new Promise((resolve, reject) => {
        let url =
            "https://gitee.com/api/v5/repos/" +
            _this.owner +
            "/" +
            _this.repo +
            "/issues?state=open&sort=created&direction=desc&page=" +
            _this.page +
            "&per_page=" +
            _this.per_page +
            "&creator=" +
            _this.owner;
        // 创建核心对象
        let xhr = new XMLHttpRequest();
        // 发送请求
        xhr.open("get", url);
        // 监听请求
        xhr.onreadystatechange = () => {
            if (xhr.readyState === 4) {
                // 如果成功则执行
                if (/^(2|3)\d{2}$/.test(xhr.status)) {
                    let date = xhr.responseText;
                    _this.text = [];
                    _this.total_count = xhr.getResponseHeader("total_count");
                    _this.total_page = Math.ceil(_this.total_count / _this.per_page);
                    if (date) {
                        date = JSON.parse(date);
                        for (let i in date) {
                            var temp = {};
                            temp.comments = date[i]["comments"];
                            temp.body = Speak.getBody(date[i]["body"]);
                            temp.labels = Speak.getLabels(_this, date[i]["labels"]);
                            temp.created_at = Speak.getTime(date[i]["created_at"]);
                            temp.html_url = date[i]["html_url"];
                            _this.text.push(temp);
                        }
                    }
                    resolve(date, xhr);
                    return;
                }
                // 失败执行
                reject(xhr.statusText, xhr);
            }
        };
        // 发送请求数据
        xhr.send(null);
    });
},

调用API后，将返回的数据再次进行提取与处理即（getBody、getLabels等方法），并将结果放入一个临时的对象，将其对象添加到数组。等渲染时遍历此数组即可。因此这个数组大概是这样的：

[
    {
        // 内容
        comments:'内容',
        labels:'标签',
        created_at:'创建时间',
        html_url:'当前issue的地址'
    },
    {
        // 内容
        comments:'内容',
        labels:'标签',
        created_at:'创建时间',
        html_url:'当前issue的地址'
    },
]

第二个问题：创建元素

jQuery的工厂函数过于好用，但为了减少体积，不得不抛弃。因此便遇到了另一个问题，dom元素的操作。

由于gitee的图片是带有防盗链的，因此需要在头部插入一个标签meta标签，表示no-referrer才可以正常使用其防盗链图片。

noRefer: function () {
    let element = document.createElement("meta");
    element.name = "referrer";
    element.content = "no-referrer";
    document.head.appendChild(element);
},

外部CSS的嵌入

由于使用了打包工具，只需要通过require进行加载即可。

loadingCss: function () {
    let element = document.createElement("style");
    element.innerHTML = require("./css/loading.css")["default"][0][1];
    document.head.appendChild(element);
},
speakCss: function () {
    let element = document.createElement("style");
    element.innerHTML = require("./css/Speak.css")["default"][0][1];
    document.head.appendChild(element);
},

按钮的插入

起初并不打算插入翻页按钮，因为嵌入到博客后，每个博客都会有自己的风格及按钮样式，但又为了初始化及使用方便，因此还是决定添加按钮和页码显示的label。

createBtn: function (_this){
    var container = document.getElementsByClassName('is-container')[0]
    container.insertAdjacentHTML('afterend',_this.prevBtn)
    container.insertAdjacentHTML('afterend',_this.nextBtn)
    container.insertAdjacentHTML('afterend',_this.pageLabel)
}

关于insertAdjacentHTML方法可参考：insertAdjacentHTML

第三个问题：代码高亮插件highlight过大

highlight.min.js文件已经100kb大小了，加上marked.min.js34kb，导致最后生成的文件大小150kb+。

不过没办法，目前无解。

如何使用

使用很简单，只需要一个class为container的容器和一个实例化的Speak对象即可。

由于基于某个主题开发，部分样式可能存在细微差别。

<div class="is-container"></div>
<script src="main.js"></script>
<script>
    new Speak(
        {
            nickname: '🦄Dreamy.TZK',
            per_page: 5,
            owner: "antmoe",
            repo: "xiaokang.me",
            defaultLabelName: "Default",
            defaultLabelColor: "#ffc107",
            // highlight样式
            highlightcss:
            "https://cdn.bootcdn.net/ajax/libs/highlight.js/10.1.1/styles/monokai-sublime.min.css",
            emojiLabel:
            {
                Coder: "🎯",
                日常: "💬",
                Whoiam: '😶',
                想法: "💫",
                TODO: "🚧",
                随便说说: "🎈",
                测试: '👻',
            },
            prevBtn:'<a class="btn-beautify button--animated left larger prev red" href="#" title="上一页" style="display:none;float:left" data-pjax-state=""><i class="far fa-hand-point-left fa-fw"></i> 上一页</a>',
            nextBtn:'<a class="btn-beautify button--animated larger next red" href="#" title="下一页" style="float: right; display: block;" data-pjax-state=""><i class="far fa-hand-point-right fa-fw"></i> 下一页</a>',
        });
</script>