Skip to content

引用来源组件的使用指南

在Atomeocean文档中,标注引用来源时可以使用<ReferenceSource>组件。该组件可以帮助您规范地展示参考文献、数据来源或外部引用,提升文档的专业性和可信度。

基本使用方法

markdown
<ReferenceSource
:sources="[
{
title: '显示为标题',
link: 'https://',
site: '原站名称',
author: '作者名字',
date: '2021-08-21',
category: '问答'
},
]"
/>

参数说明

参数名类型是否必填说明
titleString引用内容的标题
linkString引用来源的URL链接
siteString来源网站或出版物名称
authorString作者姓名或机构名称
dateString发布日期,格式为YYYY-MM-DD
categoryString内容分类,如"论文"、"新闻"、"问答"等

高级用法

多来源引用

可以同时引用多个来源:

markdown
<ReferenceSource
:sources="[
{
title: '量子计算基础',
link: 'https://example.com/quantum',
site: '科技前沿',
author: '张三',
date: '2022-03-15',
category: '论文'
},
{
title: 'AI发展趋势报告',
link: 'https://example.com/ai-trend',
site: 'AI研究院',
date: '2023-01-10',
category: '报告'
}
]"
/>

部分参数省略

非必填参数可以省略:

markdown
<ReferenceSource
:sources="[
{
title: '简明Python教程',
link: 'https://example.com/python-guide'
}
]"
/>

最佳实践建议

  1. 完整性:尽可能提供完整的引用信息,包括作者、发布日期等
  2. 链接有效性:确保提供的链接是可访问的
  3. 格式统一:保持日期等字段的格式一致性
  4. 分类明确:合理使用category字段进行分类
  5. 适度引用:避免过度引用,保持内容的原创性

显示效果

该组件会生成格式化的引用条目,通常包括:

  • 标题(可点击链接)
  • 来源网站信息
  • 作者和日期信息
  • 分类标签(如有)

注意事项

  1. 请确保引用来源的合法性
  2. 尊重原作者的版权声明
  3. 对于付费内容,建议注明访问权限要求
  4. 定期检查链接有效性,避免出现死链

如需进一步定制引用样式,请联系系统管理员获取组件样式修改指南。