git小乌龟连接码云_码云（Gitee.com）帮助文档_V1.2

码云Pages

#### 码云 `Pages` 是一个免费的静态网页托管服务，您可以使用 码云 `Pages` 托管博客、项目官网等静态网页。如果您使用过 `Github Pages` 那么您会很快上手使用码云的 `Pages`服务。目前码云 `Pages` 支持 Jekyll、Hugo、Hexo编译静态资源。

### Jekyll、Hugo、Hexo 编译判断依据

1. 编译 Hugo 依据：项目编译目录下存在`config.toml|json|yaml`文件和`content`目录的时候，会使用`hugo`生成静态文件。

2. 编译 Hexo 依据：项目编译目录下存在`package.json`，`_config.yml`文件和`scaffolds`目录的，会使用`hexo generate`生成静态文件，由于每次部署编译需要重新克隆编译并进行`npm install`，所以使用 Hexo 的时间相对 Hugo 和 Jekyll 会长一些。

3. 当不符合上述1和2条件的时候，就默认使用Jekyll编译。

### 常见问题

1. 如何创建一个首页访问地址不带二级目录的 pages，如ipvb.gitee.io？

答：如果你想你的 pages 首页访问地址不带二级目录，如ipvb.gitee.io，**你需要建立一个与自己个性地址同名的项目**，如 https://gitee.com/ipvb 这个用户，想要创建一个自己的站点，但不想以子目录的方式访问，想以`ipvb.oschina.io`直接访问，那么他就可以创建一个名字为`ipvb`的项目 https://gitee.com/ipvb/ipvb 部署完成后，就可以以 https://ipvb.gitee.io 进行访问了。

2. 当要部署的项目与自己的个性地址不一致时，部署完成后存在一些资源访问404？

答：当需要部署的项目和自己的个性地址不一致时，如：https://gitee.com/ipvb/blog ，生成的pages url 为 https://ipvb.gitee.io/blog ，而访问的资源404，如 https://ipvb.gitee.io/style.css 。这是因为相应配置文件的相对路径存在问题导致的，生成的资源 url 应该为 https://ipvb.gitee.io/blog/style.css 才对。对于不同的静态资源生成器，配置如下：

- Hugo 配置文件`config.toml`的baseURL修改如下

```

baseURL = "https://ipvb.gitee.io/blog"

```

- Hexo 配置文件`_config.yml`的`url`和`root`修改如下：

```

url: https://ipvb.gitee.io/blog

root: /blog

```

- Jekyll 配置文件`_config.yml`的 `baseurl`修改如下：

```

baseurl: "/blog" # the subpath of your site, e.g. /blog

```

3. Jekyll 中带有下划线开头文件夹或者文件无法访问，例如：_layouts

答：需要在项目目录下新建_config.yml，编写：include: [_layouts] 即可。

4. 如何自定义404？

答：在项目根目录新建 404.html 文件即可。

### 1. 使用前须知

1、项目必须有 index.html 才可以正常访问

2、静态网页的样式可以自己写，也可以拿一些静态模版来修改，`Pages`服务本身不提供任何形式的模版，但我们后续会陆续增加例子，供大家参考使用。

### 2. 一个小白的Pages搭建之旅

#### **A.新建项目 test_pages**


点击创建完成项目的创建

#### **B.添加文件 index.html (注意名称是index.html哦！)**

点击新建文件


文件名输入`index.html`，内容就是简单的`html`


点击提交，将文件提交到仓库

#### **C.选择 pages 服务**


#### **D.选择需要部署的分支，这里选择 Master 启动服务。**


#### **E.访问生成的网站地址，即可以查看你部署的静态页面啦！**



### 3. 已经有 Pages 项目如何部署到码云的 Pages

以`jQuery-File-Upload`项目为例，项目地址：https://github.com/blueimp/jQuery-File-Upload

它在Github上的Pages地址是：https://blueimp.github.io/jQuery-File-Upload/

如果想把它转移到码云`Pages`，只需要登录你的码云账户，点击右上角的`+`号，选择新建项目




然后点击创建，项目会在后台自动导入，导入成功后，点击菜单栏的服务下拉`Gitee Pages`



这里我们默认的`Pages`服务分支是项目的默认分支，但是你也已选择自己静态页面所在的分支，这里`jQuery-File-Upload`项目的静态页面分支是`gh-pages`，选择`gh-pages`并点击启动服务。


至此，静态网页已经部署成功，访问提供的地址：https://frech.gitee.io/jquery-file-upload/ 即可查看到`jQuery-File-Upload`项目的静态官网。


### 4. Pages 进阶，使用 Jekyll、Hugo、Hexo 生成自己的静态网页

Jekyll、Hugo、Hexo 究竟是什么？

Jekyll、Hugo、Hexo 是简单的博客形态的静态站点生产机器。它有一个模版目录，其中包含原始文本格式的文档，通过 Markdown 以及 Liquid 转化成一个完整的可发布的静态网站，你可以发布在任何你喜爱的服务器上。Jekyll、Hugo、Hexo 也可以运行在 码云(Gitee.com) Pages 上，也就是说，你可以使用码云的服务来搭建你的项目页面、博客或者网站，而且是完全免费的。

Jekyll 使用文档：https://www.jekyll.com.cn/docs/home/

Hugo 使用文档：https://gohugo.io/documentation/

Hexo 使用文档：https://hexo.io/docs/