CoolFace
Datasetpublic

BreadStudio/china-historical-visual-resources-index

China Historical Visual Resources Index / 中国历史视觉资料索引 (中文说明请向下滚动 / Please scroll down for the Chinese version) This is a curated metadata index of Chinese historical visual resources scattered across global collections, universities, libraries, and museums. IMPORTANT NOTE: This is a resource index / metadata dataset, NOT a direct image dataset. The dataset provides structured URLs, descriptions, and categorized entry points to historical photographs, maps, pictorials, and visual… See the full description on the dataset page: https://huggingface.co/datasets/BreadStudio/china-historical-visual-resources-index.

sourceHugging Facecc-by-nc-4.0updated 6d agoView on Hugging Face
0likes49downloads
Dataset Card

China Historical Visual Resources Index / 中国历史视觉资料索引

(中文说明请向下滚动 / Please scroll down for the Chinese version)

This is a curated metadata index of Chinese historical visual resources scattered across global collections, universities, libraries, and museums.

IMPORTANT NOTE: This is a resource index / metadata dataset, NOT a direct image dataset. The dataset provides structured URLs, descriptions, and categorized entry points to historical photographs, maps, pictorials, and visual manuscripts. It does not contain the actual historical images, as they belong to their respective rights holders and are hosted on various institutional repositories.

Relationship with the GitHub Project

This dataset is the machine-readable version of the China Historical Visual Resources GitHub Project.

  • GitHub Version: Designed for human reading, browsing, and manual discovery. It features visual examples, structured markdown layouts, and qualitative guides.
  • Hugging Face Version (This Dataset): Designed for machine readability, automated filtering, programmatic access, and downstream research tooling. It extracts all resource links, categories, and bilingual descriptions into a structured CSV format.

Dataset Structure

The dataset is provided in .csv format.

Schema

FieldTypeDescription
name_enstringEnglish name of the resource.
name_zhstringChinese name of the resource.
category_enstringThe category the resource falls into (e.g., "Streets & People", "Maps & Geography").
category_zhstringThe Chinese category name.
main_urlstringThe primary entry point or search interface URL for the resource.
example_urlstringA URL to a specific, representative item within the resource (useful for quick verification).
summary_enstringA short English summary of the resource's content.
summary_zhstringA short Chinese summary of the resource's content.
description_enstringDetailed English instructions, era hints, and usage notes for the resource.
description_zhstringDetailed Chinese instructions, era hints, and usage notes for the resource.
statusstringfeatured for fully verified main entries; to_be_confirmed for clues that require further verification of dates, access, or content.

Data Content & Missing Information

  • Images: The original GitHub repository contains sample images for presentation purposes. These images are not included in this dataset because they are meant for README decoration, and this dataset serves purely as a metadata index.
  • Unstructured Metadata: Certain attributes like precise date ranges or exact image counts are not structured as separate fields because they are often fluid or uncertain across different archives. This information is instead captured qualitatively within the description_en and description_zh fields.
  • Licensing: The licensing for the individual historical images varies heavily by collection (some are Public Domain, some CC BY, some restrictive). You must follow the main_url and verify the usage conditions on a per-collection basis.

How to Use

This dataset is ideal for:

  1. 1.Automated Discovery: Writing scripts to ping institutional repositories for updates.
  2. 2.Research Tools: Building custom search engines or dashboards for Chinese historical studies.
  3. 3.LLM RAG: Providing structured knowledge to Large Language Models about where to find specific historical visual references.

中国历史视觉资料索引

这是一份持续整理的中国历史视觉资料索引(Metadata Index),汇集了散落在世界各地大学、图书馆、博物馆等机构馆藏中的中国相关视觉资源。

重要提示: 这是一个资源索引 / 元数据集,而不是直接的图片数据集。本数据集提供了结构化的 URL、中英双语说明以及分类入口,指向历史照片、地图、画报和图像手稿。它不包含具体的历史图片文件,这些图片的版权归属于各机构或权利人,且保存在原机构的数字存储库中。

与 GitHub 项目的关系

本数据集是 中国历史视觉资料 GitHub 项目 的机器可读版本。

  • GitHub 版: 主要面向人工阅读、浏览和人工发现。它包含丰富的图片示例、MarkDown 排版以及感性的导览文字。
  • Hugging Face 版(本数据集): 主要用于机器读取、自动化筛选、程序化访问以及下游研究工具构建。它将所有资源链接、分类以及双语描述等结构化提取为了 CSV 格式。

数据集结构

本数据集以 .csv 格式提供。

字段说明 (Schema)

字段名类型说明
name_en字符串资源的英文名称。
name_zh字符串资源的中文名称。
category_en字符串资源所属的英文分类。
category_zh字符串资源所属的中文分类(如 "街头与人物"、"地图与地理")。
main_url字符串该资源的主入口或主检索界面的 URL。
example_url字符串指向该资源中具体代表性示例的 URL(方便快速验证)。
summary_en字符串关于资源内容的英文简短说明。
summary_zh字符串关于资源内容的中文简短说明。
description_en字符串英文的详细说明、年代线索及使用建议。
description_zh字符串中文的详细说明、年代线索及使用建议。
status字符串featured 代表经过验证的精选主条目;to_be_confirmed 代表仍需进一步核查年份、访问状态或具体内容的线索。

数据内容与信息边界

  • 图片处理: 原 GitHub 仓库中包含了一些用于排版和展示效果的配图。这些图片没有被放入本数据集中,因为它们仅用于 README 装饰。本数据集的定位纯粹是元数据索引(Metadata Index)。
  • 未结构化的元数据: 由于各档案库的实际情况差异巨大且经常变动,诸如“确切年份区间”或“精确图片数量”等信息没有被设计为独立的列,而是以描述性文字的形式保留在 description_zhdescription_en 中,以防止产生误导。
  • 版权与许可 (Licensing): 各历史图片的实际版权和使用许可因机构而异(有些是公有领域,有些是 CC BY,有些限制较多)。使用者必须通过 main_url 访问原站,并根据具体档案机构的规定核实图片使用条件。

适用场景

本数据集非常适合以下用途:

  1. 1.自动化发现: 编写脚本定期检查各机构数字存储库的更新。
  2. 2.研究工具: 为中国历史研究构建自定义的搜索引擎或资料面板。
  3. 3.LLM RAG: 增强大语言模型的检索生成能力,为其提供“去哪里找特定中国历史图像参考”的结构化外部知识。