中文独立博客列表项目教程

中文独立博客列表项目教程

chinese-independent-blogs中文独立博客列表项目地址:https://gitcode.com/gh_mirrors/ch/chinese-independent-blogs

1. 项目的目录结构及介绍

chinese-independent-blogs/
├── .github/
│   └── workflows/
├── .gitignore
├── LICENSE
├── README.md
├── blogs-original.csv
├── feed.opml
├── formatter.py
├── opml_generator.py
├── package-lock.json
├── package.json
├── script.js
└── ...

• .github/workflows/: 包含GitHub Actions的工作流配置文件。
• .gitignore: 指定Git应该忽略的文件和目录。
• LICENSE: 项目的许可证文件。
• README.md: 项目的介绍和使用说明。
• blogs-original.csv: 包含原始博客列表的CSV文件。
• feed.opml: 博客订阅的OPML文件。
• formatter.py: 用于格式化博客列表的Python脚本。
• opml_generator.py: 用于生成OPML文件的Python脚本。
• package-lock.json: 锁定npm包版本的文件。
• package.json: 项目的npm配置文件。
• script.js: 可能包含一些前端脚本。

2. 项目的启动文件介绍

项目的主要启动文件是opml_generator.py，它负责生成博客订阅的OPML文件。以下是该文件的简要介绍：

# opml_generator.py
import csv
import xml.etree.ElementTree as ET

def generate_opml():
    # 读取CSV文件并生成OPML文件
    with open('blogs-original.csv', newline='') as csvfile:
        reader = csv.DictReader(csvfile)
        root = ET.Element("opml", version="1.0")
        body = ET.SubElement(root, "body")
        for row in reader:
            outline = ET.SubElement(body, "outline", text=row['博客名称'], type="rss", xmlUrl=row['RSS链接'])
        tree = ET.ElementTree(root)
        tree.write("feed.opml", encoding="utf-8", xml_declaration=True)

if __name__ == "__main__":
    generate_opml()

该脚本读取blogs-original.csv文件中的博客信息，并生成一个OPML文件，用于博客订阅。

3. 项目的配置文件介绍

项目的配置文件主要是package.json，它包含了项目的依赖和脚本配置。以下是该文件的简要介绍：

{
  "name": "chinese-independent-blogs",
  "version": "1.0.0",
  "description": "中文独立博客列表",
  "main": "script.js",
  "scripts": {
    "generate": "python opml_generator.py"
  },
  "dependencies": {
    "csv-parser": "^3.0.0"
  },
  "devDependencies": {
    "eslint": "^7.23.0"
  }
}

• name: 项目的名称。
• version: 项目的版本。
• description: 项目的描述。
• main: 项目的主入口文件。
• scripts: 包含可执行的脚本命令，例如generate用于生成OPML文件。
• dependencies: 项目的运行时依赖。
• devDependencies: 项目的开发依赖。

通过这些配置文件和脚本，可以方便地管理和运行项目。

chinese-independent-blogs中文独立博客列表项目地址:https://gitcode.com/gh_mirrors/ch/chinese-independent-blogs