Gitter的初衷并不是想把网页端所有功能照搬到小程序上，因为那样的体验并不会很友好，比如说，笔者自己也不想在手机上阅读代码，那将会是一件很痛苦的事。

在保证用户体验的前提下，让用户用更简单的方式得到自己想要的，这是一件有趣的事。

二、探索篇

技术选型

第一次觉得，在茫茫前端的世界里，自己是那么渺小。

当决定去做这个项目的时候，就开始了马不停蹄的技术选型，但摆在自己面前的选择是那么的多，也不得不感慨，前端的世界，真的很精彩。

• 原生开发：基本上一开始就放弃了，开发体验很不友好；

- WePY：之前用这个框架已经开发过一个小程序，诗词墨客，不得不说，坑是真多，用过的都知道；

- mpvue：用Vue的方式去开发小程序，个人觉得文档并不是很齐全，加上近期维护比较少，可能是趋于稳定了？

- Taro：用React的方式去开发小程序，Taro团队的小伙伴维护真的很勤快，也很耐心的解答大家疑问，文档也比较齐全，开发体验也很棒，还可以一键生成多端运行的代码(暂没尝试)

货比三家，经过一段时间的尝试及踩坑，综合自己目前的能力，最终确定了Gitter的技术选型：

Taro + Taro UI + Redux + 云开发 Node.js

页面设计

其实，作为一名Coder，曾经一直想找个UI设计师妹子做老婆的(肯定有和我一样想法的Coder)，多搭配啊。现在想想，code不是生活的全部，现在的我一样很幸福。

话回正题，没有设计师老婆页面设计怎么办？毕竟笔者想要的是一款高颜值的GitHub小程序。

嗯，不慌，默默的拿出了笔者沉寂已久的Photoshop和Sketch。不敢说自己的设计能力如何，Gitter的设计至少是能让笔者自己心情愉悦的，倘若哪位设计爱好者想对Gitter的设计进行改良，欢迎欢迎，十二分的欢迎！

三、 开发篇

Talk is cheap. Show me the code.

作为一篇技术性文章，怎可能少得了代码。

在这里主要写写几个踩坑点，作为一个前端小白，相信各位读者均是笔者的前辈，还望多多指教！

Trending

进入开发阶段没多久，就遇到了第一个坑。GitHub居然没有提供Trending列表的API！！！

也没有过多的去想GitHub为什么不提供这个API，只想着怎么去尽快填好这个坑。一开始尝试使用Scrapy写一个爬虫对网页端的Trending列表信息进行定时爬取及存储供小程序端使用，但最终还是放弃了这个做法，因为笔者并没有服务器与已经备案好的域名，小程序的云开发也只支持Node.js的部署。

开源的力量还是强大，最终找到了github-trending-api，稍作修改，成功部署到小程序云开发后台，在此，感谢原作者的努力。

• 爬取Trending Repositories

async function fetchRepositories({

language = ‘’,

since = ‘daily’,

} = {}) {

const url = ${GITHUB_URL}/trending/${language}?since=${since};

const data = await fetch(url);

const $ = cheerio.load(await data.text());

return (

$(‘.repo-list li’)

.get()

// eslint-disable-next-line complexity

.map(repo => {

const $repo = $(repo);

const title = $repo

.find(‘h3’)

.text()

.trim();

const relativeUrl = $repo

.find(‘h3’)

.find(‘a’)

.attr(‘href’);

const currentPeriodStarsString =

$repo

.find(‘.float-sm-right’)

.text()

.trim() || /* istanbul ignore next */ ‘’;

const builtBy = $repo

.find(‘span:contains(“Built by”)’)

.parent()

.find(‘[data-hovercard-type=“user”]’)

.map((i, user) => {

const altString = $(user)

.children(‘img’)

.attr(‘alt’);

const avatarUrl = $(user)

.children(‘img’)

.attr(‘src’);

return {

username: altString

? altString.slice(1)

/* istanbul ignore next */ null,

href: ${GITHUB_URL}${user.attribs.href},

avatar: removeDefaultAvatarSize(avatarUrl),

};

})

.get();

const colorNode = $repo.find(‘.repo-language-color’);

const langColor = colorNode.length

? colorNode.css(‘background-color’)

null;

const langNode = $repo.find(‘[itemprop=programmingLanguage]’);

const lang = langNode.length

? langNode.text().trim()

/* istanbul ignore next */ null;

return omitNil({

author: title.split(’ / ')[0],

name: title.split(’ / ')[1],

url: ${GITHUB_URL}${relativeUrl},

description:

$repo

.find(‘.py-1 p’)

.text()

.trim() || /* istanbul ignore next */ ‘’,

language: lang,

languageColor: langColor,

stars: parseInt(

$repo

.find([href="${relativeUrl}/stargazers"])

.text()

.replace(‘,’, ‘’) || /* istanbul ignore next */ 0,

10

),

forks: parseInt(

$repo

.find([href="${relativeUrl}/network"])

.text()

.replace(‘,’, ‘’) || /* istanbul ignore next */ 0,

10

),

currentPeriodStars: parseInt(

currentPeriodStarsString.split(’ ‘)[0].replace(’,', ‘’) ||

/* istanbul ignore next */ 0,

10

),

builtBy,

});

})

);

}

复制代码

• 爬取Trending Developers

async function fetchDevelopers({ language = ‘’, since = ‘daily’ } = {}) {

const data = await fetch(

${GITHUB_URL}/trending/developers/${language}?since=${since}

);

const $ = cheerio.load(await data.text());

return $(‘.explore-content li’)

.get()

.map(dev => {

const $dev = $(dev);

const relativeUrl = $dev.find(‘.f3 a’).attr(‘href’);

const name = getMatchString(

$dev

.find(‘.f3 a span’)

.text()

.trim(),

/^((.+))$/i

);

$dev.find(‘.f3 a span’).remove();

const username = $dev

.find(‘.f3 a’)

.text()

.trim();

const $repo = $dev.find(‘.repo-snipit’);

return omitNil({

username,

name,

url: ${GITHUB_URL}${relativeUrl},

avatar: removeDefaultAvatarSize($dev.find(‘img’).attr(‘src’)),

repo: {

name: $repo

.find(‘.repo-snipit-name span.repo’)

.text()

.trim(),

description:

$repo

.find(‘.repo-snipit-description’)

.text()

.trim() || /* istanbul ignore next */ ‘’,

url: ${GITHUB_URL}${$repo.attr('href')},

},

});

});

}

复制代码

• Trending列表云函数

// 云函数入口函数
exports.main = async (event, context) => {
const { type, language, since } = event
let res = null;
let date = new Date()
if (type === ‘repositories’) {
const cacheKey = repositories::${language || 'nolang'}::${since || 'daily'};
const cacheData = await db.collection(‘repositories’).where({
cacheKey: cacheKey
}).orderBy(‘cacheDate’, ‘desc’).get()
if (cacheData.data.length !== 0 &&
((date.getTime() - cacheData.data[0].cacheDate) < 1800 * 1000)) {
res = JSON.parse(cacheData.data[0].content)
} else {
res = await fetchRepositories({ language, since });
await db.collection(‘repositories’).add({
data: {
cacheDate: date.getTime(),
cacheKey: cacheKey,
content: JSON.stringify(res)
}
})
}
} else if (type === ‘developers’) {
const cacheKey = developers::${language || 'nolang'}::${since || 'daily'};
const cacheData = await db.collection(‘developers’).where({
cacheKey: cacheKey
}).orderBy(‘cacheDate’, ‘desc’).get()
if (cacheData.data.length !== 0 &&
((date.getTime() - cacheData.data[0].cacheDate) < 1800 * 1000)) {
res = JSON.parse(cacheData.data[0].content)
} else {
res = await fetchDevelopers({ language, since });
await db.collection(‘developers’).add({
data: {
cacheDate: date.getTime(),
cacheKey: cacheKey,
content: JSON.stringify(res)
}
})
}
}
return {
data: res
}
}
复制代码

Markdown解析

嗯，这是一个大坑。

在做技术调研的时候，发现小程序端Markdown解析主要有以下方案：

- wxParse：作者最后一次提交已是两年前了，经过自己的尝试，也确实发现已经不适合如README.md的解析

- wemark：一款很优秀的微信小程序Markdown渲染库，但经过笔者尝试之后，发现对README.md的解析并不完美

- towxml：目前发现是微信小程序最完美的Markdown渲染库，已经能近乎完美的对README.md进行解析并展示

在Markdown解析这一块，最终采用的也是towxml，但发现在解析性能这一块，目前并不是很优秀，对一些比较大的数据解析也超出了小程序所能承受的范围，还好贴心的作者(sbfkcel)提供了服务端的支持，在此感谢作者的努力！

• Markdown解析云函数

const Towxml = require(‘towxml’);
const towxml = new Towxml();

// 云函数入口函数
exports.main = async (event, context) => {
const { func, type, content } = event
let res
if (func === ‘parse’) {
if (type === ‘markdown’) {
res = await towxml.toJson(content || ‘’, ‘markdown’);
} else {
res = await towxml.toJson(content || ‘’, ‘html’);
}
}
return {
data: res
}
}
复制代码

• markdown.js组件

import Taro, { Component } from ‘@tarojs/taro’
import PropTypes from ‘prop-types’
import { View, Text } from ‘@tarojs/components’
import { AtActivityIndicator } from ‘taro-ui’

import ‘./markdown.less’

import Towxml from ‘…/towxml/main’

const render = new Towxml()

export default class Markdown extends Component {
static propTypes = {
md: PropTypes.string,
base: PropTypes.string
}

static defaultProps = {
md: null,
base: null
}

constructor(props) {
super(props)
this.state = {
data: null,
fail: false
}
}

componentDidMount() {
this.parseReadme()
}

parseReadme() {
const { md, base } = this.props
let that = this
wx.cloud.callFunction({
// 要调用的云函数名称
name: ‘parse’,
// 传递给云函数的event参数
data: {
func: ‘parse’,
type: ‘markdown’,
content: md,
}
}).then(res => {
let data = res.result.data
if (base && base.length > 0) {
data = render.initData(data, {base: base, app: this.$scope})
}
that.setState({
fail: false,
data: data
})
}).catch(err => {
console.log(‘cloud’, err)
that.setState({
fail: true
})
})
}

render() {
const { data, fail } = this.state
if (fail) {
return (

load failed, try it again?

)
}
return (

{
data ? (




) : (



)
}

)
}
}
复制代码