Public Money Public Code 亚洲项目教程

Public Money Public Code 亚洲项目教程

publiccode.asia Website of https://publiccode.asia 项目地址: https://gitcode.com/gh_mirrors/pu/publiccode.asia

1. 项目目录结构及介绍

Public Money Public Code 亚洲项目（以下简称 PMPC Asia）的目录结构如下：

publiccode.asia/
├── site/
│   ├── config-static.toml
│   ├── content/
│   ├── data/
│   ├── layouts/
│   ├── public/
│   ├── static/
│   ├── templates/
│   ├── themes/
│   └── translate/
├── .drone.yml
├── .gitignore
├── .travis.yml
├── CONTRIBUTING.md
├── Dockerfile
├── LICENSE
├── README.md
├── TRANSLATE.md
├── _config.yml
├── deploy.sh
├── donate.html
├── fake-commit
├── hosts
├── id_rsa.enc
├── playbook.yml
├── proxy.sh
├── script.js
├── signatures.js
├── spreadsheets.gs
├── style.css
└── view.sh

以下是各目录和文件的简要介绍：

• site/: 包含网站的主要文件和目录。

  • config-static.toml: 网站静态配置文件。
  • content/: 存放网站内容的 Markdown 文件。
  • data/: 包含各种数据文件，如组织信息、分享服务等。
  • layouts/: 网站的 HTML 模板文件。
  • public/: 生成的静态网站文件。
  • static/: 包含网站的静态资源，如 CSS、JavaScript 和图片。
  • templates/: Hugo 模板文件。
  • themes/: Hugo 主题目录。
  • translate/: 翻译文件，用于网站的多语言支持。

• .drone.yml: Drone CI/CD 配置文件。

• .gitignore: Git 忽略文件。

• .travis.yml: Travis CI 配置文件。

• CONTRIBUTING.md: 贡献指南。

• Dockerfile: Docker 容器配置文件。

• LICENSE: 项目许可证文件。

• README.md: 项目说明文件。

• TRANSLATE.md: 翻译指南。

• _config.yml: Hugo 配置文件。

• deploy.sh: 部署脚本。

2. 项目的启动文件介绍

publiccode.asia 项目的启动主要通过以下文件进行：

• Dockerfile: 用于构建 PMPC Asia 的 Docker 容器镜像。
• deploy.sh: 脚本用于部署网站。

使用 Docker 启动项目：

1. 克隆项目仓库到本地：

   git clone https://github.com/fossasia/publiccode.asia.git
   cd publiccode.asia
   

2. 构建 Docker 镜像：

   docker build -t pmpcasia .
   

3. 运行 Docker 容器：

   docker run -p 1313:1313 pmpcasia
   

使用本地环境启动项目：

1. 确保已安装 Hugo。

2. 在项目根目录下运行：

   hugo server -D
   

然后在浏览器中访问 http://localhost:1313，即可查看项目。

3. 项目的配置文件介绍

项目的配置主要通过以下文件进行：

• config-static.toml: 网站的静态配置文件，包含网站标题、描述等。
• _config.yml: Hugo 的配置文件，定义了网站的基本信息和主题设置。

config-static.toml 文件示例：

baseURL = "https://publiccode.asia/"
languageCode = "zh-CN"
title = "Public Money Public Code - 亚洲"
description = "推动公共资金支持的开源代码项目。"

_config.yml 文件示例：

paginate = 5
paginatePath = "page"
theme = "hyde"

以上配置文件定义了网站的基本信息和主题样式，可以根据需要进行修改。

publiccode.asia Website of https://publiccode.asia 项目地址: https://gitcode.com/gh_mirrors/pu/publiccode.asia