HelloGitHub.com 网站开源了

简介

随着 HelloGitHub 月刊持续更新了一年多，内容变的愈来愈多。由于内容数据没有结构化，若是仍是使用以前的编辑文本的方式编辑月刊内容，会对后面的继续发刊和维护带来了不少问题和多余的工做，例如：查看、查重、分类、排序、修改、同步内容等

最初 是使用本地数据库的方式进行管理数据，经过脚本生成内容，数据仍是很容易出错。

后面 随着内容的增多，为了便于用户的分类查看，打算作个网站，利于展现和查阅。

最后 为了方便的管理展现的内容，同时简化月刊的发布流程，就打算开发个后台。

技术选型：

• Flask：轻量级 Python Web 开发框架
• Peewee：轻量级 Python ORM 库
• Purecss：轻量级 CSS 框架
• SQLite：轻量级数据库

网站效果：

网站地址：HelloGitHub.com

为何开源

首先本项目受益于开源，正是由于众多的开源库，使得我在开发这个网站的过程变的十分容易，不可思议没有这些开源的库。

其次，个人 HelloGitHub 月刊是推荐开源项目，那么这个网站开源也是必然的。

关于进阶

我发如今学习编程的过程当中，入门资料十分的多，可是进阶的资料少之又少。这种现象不局限于某种语言，而是广泛想象。为何会有这种显现呢？

入门是简单的，只要跟着输入指令获得预期的结果，就算过关。然而在入门阶段，不少概念不是那么容易理解，只是会使用或者说“照猫画虎”能够写出来。而后，当基础教程学习完成，打算动手写个项目的时候，发现步履维艰。而后就开始怀疑本身是否适合编程这条路，这就是为何编程进阶的阶段会卡住不少人。

在讨论：“概念不理解”、“不知道写什么”这些问题以前，我以为能够先讨论下：编程是什么？

百度百科：让计算机为解决某个问题，对某个计算体系规定必定的运算方式，是计算体系按照该计算方式运行，并最终获得相应结果的过程。

简而言之，编程是为了让计算机帮助咱们解决某个问题，而编程语言是与计算沟通的桥梁。这也就是说，全部的编程技巧和特性都是为了让咱们更好的去解决实际的问题。

那么是否能够反思得出，入门时学习编程语言，一味的注重记住语法、而不去思考为何会有这种特性和语法？就像学习汉字的过程，若是在学到一个新字时候，就去想在哪里见过、有什么词组、它是什么意思、如何使用它，而不是记住他详细的笔画。

拿编程中的面向对象举例：我在学习 Java 语言的时候，就接触到了面向对象，而后学习 Python 也遇到了这个概念。在介绍完这个概念就会学 “类” 这一章。每次到这一章，我就开始怀疑人生！我根本不懂面向对象的概念，就让我写类，我只能死记硬背、照猫画虎。随着照着写玩的代码能够跑了，随后而来的是我对编程失去信心了。

直到，我阅读、编写的代码量积累到必定的量的时候，我才真正的明白面向对象的意思：封装、继承，这给编程带来多大的便利。不少时候不是老师教授课的能力问题、本身的理解能力的问题。而是编程这门学科，在我看来是为了使用计算机解决实际问题而诞生的。全部的技巧都是为了更好的使用计算机解决问题，那么这些技术都是经过解决问题的过程当中积累、总结而来的。若是不经过实际的理解使用，是没法理解这种技术的目的和优点的。

回到如何解决 “概念不理解”、“不知道写什么”这些问题，个人办法是阅读、编写代码，用代码解决实际问题。 在不会写代码的时候，多看别人怎么使用某一种编程问题去解决问题的；在写代码的过程当中，要多看文档、错误信息；能写100行代码后，就考虑下这些代码有没有冗余的地方？若是让它变的更加易读和使用。

最后，这就是为何我推崇开源的缘由。正是丰富的开源资源让我学到了不少编程技巧同时融汇贯通、有意思的开源项目让我发现编程的乐趣，让我在编程的这条路上越走越远。

本项目的愿景

此项目基于 Flask 开发，如今只开发了一些基本功能，并无集成 flask 的第三方库。现已发开的功能：

• OAuth 登录
• 后台内容管理
• 前端异步展现

之因此如此简陋就选择开源。由于，我想呈现的就是从零到一的过程。在这个过程当中，历经的开发、集成库、重构的过程和思想， 才是我想分享给你们的。经过上述的过程可让新手更好的理解 开源思想、第三方库的优劣、Web 开发技术、开发流程 等。

我但愿 hellogithub.com 这个项目能够作成一个系列教程，主要目的是：以实际 Web 开发项目为主要呈现，去理解、加入开源，发现编程的乐趣。

我认为持续的天然成长才是进阶的解决之道，而不多是醍醐灌顶的飞跃。在学会了如何参与开源、使用开源社区的资源、解决问题的思路，在进阶的路上会越走越高，越走越顺畅。

如何启动本项目

1. 下载项目：git clone https://github.com/521xueweihan/hellogithub.com.git
2. 安装依赖：pip install -r requirements.txt
3. 配置
4. 启动：python server.py

配置步骤以下：

在该目录下：/项目地址/hellogithub.com/hellogithub/hellogithub/ 建立 config.py，配置内容以下：

#/usr/bin/env python
# -*- coding:utf-8 -*-
from os import path

DEBUG = True
SECRET_KEY = 'test_secret_key'
STATIC_PATH = path.join(path.dirname(__file__), 'static')

PAGE_MAX = 5
GITHUB_IMAGE_URL = u'https://raw.githubusercontent.com/521xueweihan/HelloGitHub/{path}'
GITHUB_IMAGE_PREFIX = u'https://github.com/521xueweihan/HelloGitHub/blob/'
GITHUB_IMAGE_PATH_PREFIX = u'master/content/{volume_name}/img/{image_name}'

APP_DIR = '/项目地址/hellogithub.com/hellogithub'

GITHUB_TEMPLAT_PATH = path.join(APP_DIR, 'output_template/github_template.md')
GITBOOK_TEMPLAT_PATH = path.join(APP_DIR, 'output_template/gitbook_template.md')

DATABASE = 'sqliteext:///%s' % path.join(APP_DIR, 'test_hellogithub.db')


# GitHub OAuth local
CLIENT_ID = '02f1c617c1b20948b635'
CLIENT_SECRET = '2102c5c75d7482acf70a09317b697d6892380adc'
AUTHORIZE_URL = 'https://github.com/login/oauth/authorize/'
ACCESS_URL = 'https://github.com/login/oauth/access_token/'

开启 admin 权限：

• 登录一次
• 修改数据库中 admin 字段为 1
• 注销，从新登录
• 点击用户名便可跳转到管理后台

最后

个人前端技术很菜，须要前端小伙伴一块儿飞。同时，但愿老司机也能带带我，对本项目和之后的规划提出建设性意见。
因此，我留下个人微信号，后面可能会拉个微信群一块儿交流，让这个项目可以帮助到更多的人。

• 个人微信号：xueweihan（请备注：hellogithub）
• 还有我是男的，个人头像是”朴信惠”