发布你的静态页面 - Github Pages

Github的主页服务 Github提供了Github Pages的服务来帮助你为自己的项目提供主页。目前,这种主页服务分为两种:用户主页和项目主页。其中用户主页已经称为广大开发者的标配,有很多的开发者已经将自己的博客迁移到了Github上,其中所用到的核心机制就是Github Pages。 这篇文章主要介绍如何使用项目主页。项目主页,顾名思义,就是你项目的主页,本来设计的初衷是为你的项目编写介绍文档,不过Github只提供对静态内容的托管。如果需要添加评论,可以使用disqus的服务,而和微博,flickr等集成都有现成的JavaScript片段,这里也不做详细讨论。 你现在正在看的我的博客正是托管在Github上,不过我对域名进行了自定义而已,如何做到这一点可以查看此处的文档。 我之前发布的一个我去过的地方就使用了项目主页的服务,该项目的地址在此,最终的页面在这里。 Web设计样板工程 我在Github上创建了一个设计样板工程,你可以使用这个工程快速的搭建一个完整的样板工程,其中包含了: 一个基本的HTML5的文档 SCSS环境 Guard环境,可以与LiveReload集成 具体的操作可以参看文档。 发布你的Web设计 Github提供的项目主页服务可以帮助你快速将设计发布,你所需要做的就是为项目创建一个名叫gh-pages的分支,然后将HTML/CSS/JS放在这个分支上即可。 假设你在github上的用户名为wumai(一时间想不到好名字,看看窗外,就叫雾霾吧),那么根据惯例,你的Github地址为https://github.com/wumai。这时候,假设你的项目(repo)的名称为design-1,则你的项目主页地址为https://wumai.github.io/design-1。 知道了你的项目主页地址,你就需要为这个页面添加内容了: $ git clone git@github.com:abruzzi/design-boilerplate.git design-1 克隆了design-boilerplate之后, $ cd design-1 $ git remote -v 你可以看到当前的项目是和git@github.com:abruzzi/design-boilerplate.git关联的, origin git@github.com:abruzzi/design-boilerplate.git (fetch) origin git@github.com:abruzzi/design-boilerplate.git (push) 你需要先和这个样板工程解除绑定: $ git remote remove origin 然后你需要在Github上创建一个新的Repo,假设命名为design-1,这时候,将这个新创建的Repo作为你本地的remote: $ git remote add -u origin git@github.com:wumai/design-1.git 与远程连接之后,我们可以开始实际的设计了,不过在这之前,需要先创建一个gh-pages分支: $ git checkout -b gh-pages 这条命令会创建gh-pages分支,并切换到该分支,这样后续的修改都会在该分支进行,这也正是我们想要的。开发调试之后,就可以将这个分支push到Github: $ git push -u origin gh-pages 好了,现在打开地址http://wumai.github.io/design-1,应该就可以看到你自己的设计了。

November 21, 2014 · 1 min · 邱俊涛 | Juntao Qiu

从Google Code迁移至Github

###一些闲话 虽然对开源社区没有任何杰出的贡献,但是我自己在业余时间开发的很多小东西都是开源的,有部分放在google code上,可是除了一个sTodo有几个用户外,其他的工具几乎都纯属自娱自乐。虽然当时做的时候自己非常投入,会各种YY,假设用户会需要这个功能,会需要那个功能,用户会需要脚本化,自定义插件等等,但是到最后发现只有自己在使用,而再过一段时间,连自己也不会使用了。 我自己托管在google code上的,还算有点用处的项目有三个: sTodo 一个简单的todo管理器 phoc 一个可以用JavaScript脚本化的计算器 utouch 一个使用styledTextCtrl的编辑器 虽然这种事情发生在几乎每一个喜欢写程序的家伙身上,但是整个过程对自我修炼来说,还是非常有现实意义的,首先专业技能得到了锻炼,而最重要的一点是:需求不是想象出来的!在没有和用户真正仔细的讨论之前,我们的假设和推断往往是错的。 Idea到处都是,有很多很酷且很有挑战的idea,但是它们不一定真的在解决人们的问题。这是一个很值得思考的问题,我最近在尝试组织一个活动,主题以及目标已经确定,上周找胡凯帮我把关,结果发现我又一次的进入了“帮助用户想需求”的老路上了。 ###迁移 ####使用svn同步到本地 根据google code的提示,将code从svn中的checkout到本地: svn checkout http://phoc.googlecode.com/svn phoc-read-only ####去除掉.svn隐藏目录 现使用find在当前目录下找到名称为.svn的目录,然后将其删除,这个过程是递归的,即可以清除掉当前目录及所有子目录中的.svn目录: find . -name ".svn" -type d -exec rm -rf {} \; ####初始化git的repo git init git add . git ci -m "migrate of project xxx to github" 然后对应的在github上创建repo,创建之后,需要将本地的remote指向github上的repo: git remote add origin git@github.com:project/project.git 如果本地的master分支没有配置,可以在.git/config中进行配置: [branch "master"] remote = origin merge = refs/heads/master 最后将新的commit push到新的repo上即可: git pull --rebase git push 我已经把这个工具迁移到了github上abruzzi,正式告别了google code。

January 13, 2013 · 1 min · 邱俊涛 | Juntao Qiu