浅谈Github多人合作开发

前言:

之前的一篇文章介绍了如何搭建自己的Git服务器,在自己搭建的Git服务器上,多人合作一般都采用创建证书登录方式(文章中也有介绍),即简单又方便。今天主要介绍Github上多人合作的开发方式。

Github多人合作开发方式主要分两种:

  1. Collaborators
  2. Fork & Pull request

本文首发于马燕龙个人博客,欢迎分享,转载请标明出处。


1、Collaborators:

使用场景:

Collaborators适用于一个Team之间的团队开发。比如张三有一个项目,Repo地址为ZhangSan/RepoA,这时张三就可以邀请自己的项目组成员或小伙伴一起开发这个项目了。

怎样邀请:

进入Repo,点击Settings-> Collaborators-> Add collaborator 即可邀请。

clone及push代码:

被邀请的开发者clone地址为:https://github.com/ZhangSan/RepoA,开发者修改代码(branch、commit、merge、push),push后会更新ZhangSan/RepoA。
第一次push代码时需要输入自己的账号密码进行验证,如果账号在Collaborators中,就可以push成功。

2、Fork & Pull request

使用场景:

Fork & Pull request方式适用于开源项目。比如张三有一个很牛的开源项目,Repo地址为ZhangSan/RepoA。李四看着不错想做点贡献,就Fork一个到自己的Repo中,地址为LiSi/RepoA。

clone及push代码:

李四clone地址为:https://github.com/LiSi/RepoA,李四可以任意修改该仓库的代码(branch、commit、merge、push),push后只会更新LiSi/RepoA,任何操作都不会影响ZhangSan/RepoA。

化学反应:

有一天,李四开发了一个不错的功能,想推荐给张三,就可以在自己Fork的仓库LiSi/RepoA里发一个pull request,问问张三要不要。

提交后张三的仓库ZhangSan/RepoA将会收到一个pull request。张三如果觉得不错,就可以将LiSi/RepoA Merge ZhangSan/RepoA,如果觉得有问题,也可以用comment讨论。(ZhangSan/RepoA 所有的Collaborators都可以处理)


交友互动:

本文首发于马燕龙个人博客,欢迎分享,转载请标明出处。
马燕龙个人博客:http://www.mayanlong.com
马燕龙个人微博:http://weibo.com/imayanlong
马燕龙Github主页:https://github.com/yanlongma

Typecho - MyTagCloud标签云插件

一、前言:

标签云是博客、CMS类系统的常见功能,读者可以根据标签快速的查找和浏览自己喜欢的文章。个人很喜欢Typecho的简洁,但对于后台不能控制前台标签栏目的显示还是略表遗憾。令人高兴的是Typecho的插件机制可以让Typecho Fans很容易的开发出自己想要的插件,于是决定自己开发一个标签云插件。

该插件已被Typecho官方Merge。本文首发于马燕龙个人博客,欢迎分享,转载请标明出处。

二、资料:

三、效果:

MyTagCloud02.gif

四、使用帮助:

  1. 下载插件(点击下载
  2. 将插件上传到/usr/plugins/目录
  3. 在需要使用标签云的模板中放入如下PHP代码 Typecho_Plugin::factory('usr/themes/sidebar.php')->tagCloud();
  4. 登陆后台,在菜单“控制台->插件”中启用插件,并根据自己需求进行配置即可轻松使用
  5. 如果标签云模板结构不同,重写插件中render()方法即可

代码如下:

<?php
if (!defined('__TYPECHO_ROOT_DIR__')) exit;
/**
 * MyTagCloud插件,后台控制前台标签智能显示
 *
 * @package MyTagCloud
 * @author  Ma Yanlong
 * @version 1.0.0
 * @link http://www.mayanlong.com
 */
class MyTagCloud_Plugin implements Typecho_Plugin_Interface
{

    // 是否启用
    const ENABLE_YES = 10;  //启用
    const ENABLE_NO = 20;  //不启用

    // 是否显示没使用的标签
    const ZERO_SHOW = 10;   //显示
    const ZERO_HIDE = 20;   //不显示

    /**
     * 激活插件方法,如果激活失败,直接抛出异常
     *
     * @access public
     * @return void
     * @throws Typecho_Plugin_Exception
     */
    public static function activate()
    {
        // factory('name') name是插件接口名称 可以取任何名称 为方便寻找我们以文件目录命名
        Typecho_Plugin::factory('usr/themes/sidebar.php')->tagCloud = array('MyTagCloud_Plugin', 'process');
    }

    /**
     * 禁用插件方法,如果禁用失败,直接抛出异常
     *
     * @static
     * @access public
     * @return void
     * @throws Typecho_Plugin_Exception
     */
    public static function deactivate(){}

    /**
     * 获取插件配置面板
     *
     * @access public
     * @param Typecho_Widget_Helper_Form $form 配置面板
     * @return void
     */
    public static function config(Typecho_Widget_Helper_Form $form)
    {

        // 是否启用
        $compatibilityMode = new Typecho_Widget_Helper_Form_Element_Radio('enable', array(
            self::ENABLE_YES   =>  _t('启用'),
            self::ENABLE_NO   =>  _t('不启用')
        ), self::ENABLE_YES, _t('是否启用该插件'), _t("启用后将这段PHP代码放到需要显示标签的模板中即可 Typecho_Plugin::factory('usr/themes/sidebar.php')->tagCloud(); "));
        $form->addInput($compatibilityMode->addRule('enum', _t('必须选择一个模式'), array(self::ENABLE_YES, self::ENABLE_NO)));

        // 是否显示没使用的标签
        $compatibilityMode = new Typecho_Widget_Helper_Form_Element_Radio('zero', array(
            self::ZERO_SHOW   =>  _t('显示'),
            self::ZERO_HIDE   =>  _t('不显示')
        ), self::ZERO_SHOW, _t('显示没使用的标签'), _t("默认显示所有标签,请根据自己需要进行设置。"));
        $form->addInput($compatibilityMode->addRule('enum', _t('必须选择一个模式'), array(self::ZERO_SHOW, self::ZERO_HIDE)));

        // 前台显示栏目标题
        $title = new Typecho_Widget_Helper_Form_Element_Text('title', NULL, '标签', _t('前台显示栏目标题'));
        $form->addInput($title);

        // 最多显示标签数量
        $limit = new Typecho_Widget_Helper_Form_Element_Text('limit', NULL, '20', _t('最多显示标签数量'));
        $form->addInput($limit);
    }

    /**
     * 个人用户的配置面板
     *
     * @access public
     * @param Typecho_Widget_Helper_Form $form
     * @return void
     */
    public static function personalConfig(Typecho_Widget_Helper_Form $form){}

    /**
     * 插件实现方法
     *
     * @access public
     * @return void
     */
    public static function process()
    {
        $enable = Typecho_Widget::widget('Widget_Options')->plugin('MyTagCloud')->enable;
        $zero = Typecho_Widget::widget('Widget_Options')->plugin('MyTagCloud')->zero;
        $title = Typecho_Widget::widget('Widget_Options')->plugin('MyTagCloud')->title;
        $limit = (int)Typecho_Widget::widget('Widget_Options')->plugin('MyTagCloud')->limit;

        // 是否启用
        if ($enable != self::ENABLE_YES) {
            return;
        }

        // 查找满足条件的标签
        $tags = Typecho_Widget::widget('Widget_Metas_Tag_Cloud', array(
            'sort' => 'count',
            'ignoreZeroCount' => $zero == self::ZERO_HIDE ? true : false,
            'desc' => true,
            'limit' => $limit
        ));

        // 是否有标签
        if ($tags->have()) {
            self::render($title, $tags);
        }
    }

    /**
     * 输出Html标签
     *
     * @access public
     * @return void
     */
    public static function render($title, $tags)
    {
        // 拼接并输出html
        $html = '<section class="widget">
                    <h3 class="widget-title">'. $title .'</h3>
                    <div class="widget-list">';

                        while ($tags->next()) {
                            $html .= "<a href='{$tags->permalink}' style='display: inline-block; margin: 0 5px 5px 0;'>{$tags->name}</a>";
                        }

        $html .=    '</div>
                </section>';

        echo $html;
    }


}


交友互动:

本文首发于马燕龙个人博客,欢迎分享,转载请标明出处。
马燕龙个人博客:http://www.mayanlong.com
马燕龙个人微博:http://weibo.com/imayanlong
马燕龙Github主页:https://github.com/yanlongma

iOS开发 - Swift实现清除缓存功能

前言:

开发移动应用时,请求网络资源是再常见不过的功能。如果每次都去请求,不但浪费时间,用户体验也会变差,所以移动应用都会做离线缓存处理,其中已图片缓存最为常见。但是时间长了,离线缓存会占用大量的手机空间,所以清除缓存功能基本是移动应用开发的标配。

本文首发于马燕龙个人博客,欢迎分享,转载请标明出处。


实现:

本文介绍在iOS开发中,Swift实现清除缓存功能。主要分为统计缓存文件大小和删除缓存文件两个步骤:

1、统计缓存文件大小

func fileSizeOfCache()-> Int {
    
    // 取出cache文件夹目录 缓存文件都在这个目录下
    let cachePath = NSSearchPathForDirectoriesInDomains(NSSearchPathDirectory.CachesDirectory, NSSearchPathDomainMask.UserDomainMask, true).first
    //缓存目录路径
    print(cachePath)
    
    // 取出文件夹下所有文件数组
    let fileArr = NSFileManager.defaultManager().subpathsAtPath(cachePath!)
    
    //快速枚举出所有文件名 计算文件大小
    var size = 0
    for file in fileArr! {
        
        // 把文件名拼接到路径中
        let path = cachePath?.stringByAppendingString("/\(file)")
        // 取出文件属性
        let floder = try! NSFileManager.defaultManager().attributesOfItemAtPath(path!)
        // 用元组取出文件大小属性
        for (abc, bcd) in floder {
            // 累加文件大小
            if abc == NSFileSize {
                size += bcd.integerValue
            }
        }
    }
    
    let mm = size / 1024 / 1024
    
    return mm
}

2、删除缓存文件

func clearCache() {
    
    // 取出cache文件夹目录 缓存文件都在这个目录下
    let cachePath = NSSearchPathForDirectoriesInDomains(NSSearchPathDirectory.CachesDirectory, NSSearchPathDomainMask.UserDomainMask, true).first
    
    // 取出文件夹下所有文件数组
    let fileArr = NSFileManager.defaultManager().subpathsAtPath(cachePath!)
    
    // 遍历删除
    for file in fileArr! {
        
        let path = cachePath?.stringByAppendingString("/\(file)")
        if NSFileManager.defaultManager().fileExistsAtPath(path!) {
            
            do {
                try NSFileManager.defaultManager().removeItemAtPath(path!)
            } catch {
                
            }
        }
    }
}

3、效果图

清除缓存01.gif


交友互动:

本文首发于马燕龙个人博客,欢迎分享,转载请标明出处。
马燕龙个人博客:http://www.mayanlong.com
马燕龙个人微博:http://weibo.com/imayanlong
马燕龙Github主页:https://github.com/yanlongma

搭建自己的Git服务器

前言:

GitHub是一个免费托管开源代码的远程仓库,使用起来即方便又安全,但在国内有时访问巨慢,原因你懂得。还有一些公司和个人视源码如生命,既不想开源代码又不想给Github交保护费。这时搭建一个自己的Git服务器就很有必要了,下面介绍如何在CentOS上搭建自己的Git服务器。

本文首发于马燕龙个人博客,欢迎分享,转载请标明出处。


一、搭建Git服务器及使用

1、安装Git

执行以下命令安装git

$ yum install curl-devel expat-devel gettext-devel openssl-devel zlib-devel perl-devel
$ yum install git

接下来我们创建一个git用户组和用户,用来运行git服务:

$ groupadd git
$ useradd git -g git
$ passwd yourpwd

最好切换到git用户 不然后面新建的git仓库都要改权限 烦烦烦!!

$ su - git  

2、创建证书登录

收集所有需要登录的用户的公钥,公钥位于id_rsa.pub文件中,把我们的公钥导入到/home/git/.ssh/authorized_keys文件里,一行一个。

如果没有该文件则创建它:

$ cd /home/git/
$ mkdir .ssh
$ chmod 700 .ssh
$ touch .ssh/authorized_keys
$ chmod 600 .ssh/authorized_keys

3、初始化Git仓库

首先我们选定一个目录作为Git仓库,假定我们放在git用户的宿主目录/home/git/,在/home/git/目录下输入命令:

$ cd /home/git
$ git init --bare test.git
Initialized empty Git repository in /home/git/test.git/

以上命令会创建一个空仓库,服务器上的Git仓库通常都以.git结尾。

4、克隆仓库

$ git clone git@your-ip:test.git
Cloning into 'test'...
warning: You appear to have cloned an empty repository.
Checking connectivity... done.

your-ip 为您 Git 所在服务器 ip 。

5、禁止Shell登录

出于安全考虑,git用户不允许登录shell,这可以通过编辑/etc/passwd文件完成。
找到类似下面的一行:

git:x:502:502::/home/git:/bin/bash

改为

git:x:502:502::/home/git:/usr/bin/git-shell

这样,git用户可以正常通过ssh使用git,但无法登录shell,因为我们为git用户指定的git-shell每次一登录就自动退出。


二、注意事项及说明

1、git仓库可以放在任何目录

放在/home/git目录下(clone相对于git宿主目录 /home/git/)
git clone git@your-ip:test.git

放在根目录,新建git目录作为仓库(绝对路径 /git/)
git clone git@your-ip:/git/test.git

如果域名绑定IP就可以直接用域名clone
git clone git@www.mayanlong.com:test.git

2、目录权限问题

如果不是用git用户创建的,注意以下目录文件的权限问题。
.ssh
test.git...

如果有问题,可以把该目录的所属者改成git。
$ chown -R git:git test.git


交友互动:

本文首发于马燕龙个人博客,欢迎分享,转载请标明出处。
马燕龙个人博客:http://www.mayanlong.com
马燕龙个人微博:http://weibo.com/imayanlong
马燕龙Github主页:https://github.com/yanlongma

Markdown - 语法简介

本文首发于马燕龙个人博客,欢迎分享,转载请标明出处。

标题

在文字里书写不同数量的“#”可以完成不同的标题,如下:

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

列表

无序列表的使用,在符号“-”后加空格使用。如下:

- 无序列表1
- 无序列表2
- 无序列表3

如果要控制列表的层级,则需要在符号“-”前使用空格。如下:

- 无序列表1
- 无序列表2
  - 无序列表2.1
     - 列表内容
     - 列表内容

有序列表的使用,在数字及符号“.”后加空格几个,如下:

1. 有序列表1
2. 有序列表2
3. 有序列表3

有序列表如果要区分层级,也可以在数字前加空格。

引用

引用的格式是使用符号“>”后面书写文字,及可以使用引用。如下:

> 这个是引用
> 是不是和电子邮件中的
> 引用格式很像

粗体与斜体

斜体的使用则是在需要斜体的文字前后各加一个“*”,而粗体的使用是在需要加粗的文字前后各加两个“*”,如果要使用粗体和斜体,那么就是在需要操作的文字前后各加三个“*”。如下:

*这个是斜体*
**这个是粗体**
***这个是粗体加斜体***

链接与图片

在文中直接加链接,中括号中是需要添加链接的文字,圆括号中是需要添加的链接,如下:
[link text](http://example.com/ "optional title")

在引用中加链接,第一个中括号添加需要添加的文字,第二个中括号中是引用链接的id,之后在引用中,使用id加链接:如下:
[link text][id]
[id]: http://example.com/ "optional title here"

在文中直接引用链接,直接使用尖括号,把链接加入到尖括号中就可以实现,如下:
<http://example.com/> or <address@example.com>

插入互联网上图片,格式如下:
![这里写图片描述](http://img3.douban.com/mpic/s1108264.jpg)
![这里写图片描述][jane-eyre-douban]
[jane-eyre-douban]: http://img3.douban.com/mpic/s1108264.jpg

分割线与删除线

可以在一行中用三个以上的星号、减号、底线来建立一个分隔线,同时需要在分隔线的上面空一行。如下:

---
****
___

删除线的使用,在需要删除的文字前后各使用两个符合“~”,如下

~~Mistaken text.~~

代码块与语法高亮

在需要高亮的代码块的前一行及后一行使用三个反引号“`”,同时第一行反引号后面表示代码块所使用的语言,如下:

``` swift
print("Hello World!")
```

交友互动:

本文首发于马燕龙个人博客,欢迎分享,转载请标明出处。
马燕龙个人博客:http://www.mayanlong.com
马燕龙个人微博:http://weibo.com/imayanlong
马燕龙Github主页:https://github.com/yanlongma