引用来源组件的使用指南
在Atomeocean文档中,标注引用来源时可以使用<ReferenceSource>
组件。该组件可以帮助您规范地展示参考文献、数据来源或外部引用,提升文档的专业性和可信度。
基本使用方法
markdown
<ReferenceSource
:sources="[
{
title: '显示为标题',
link: 'https://',
site: '原站名称',
author: '作者名字',
date: '2021-08-21',
category: '问答'
},
]"
/>
参数说明
参数名 | 类型 | 是否必填 | 说明 |
---|---|---|---|
title | String | 是 | 引用内容的标题 |
link | String | 是 | 引用来源的URL链接 |
site | String | 否 | 来源网站或出版物名称 |
author | String | 否 | 作者姓名或机构名称 |
date | String | 否 | 发布日期,格式为YYYY-MM-DD |
category | String | 否 | 内容分类,如"论文"、"新闻"、"问答"等 |
高级用法
多来源引用
可以同时引用多个来源:
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'
}
]"
/>
最佳实践建议
- 完整性:尽可能提供完整的引用信息,包括作者、发布日期等
- 链接有效性:确保提供的链接是可访问的
- 格式统一:保持日期等字段的格式一致性
- 分类明确:合理使用category字段进行分类
- 适度引用:避免过度引用,保持内容的原创性
显示效果
该组件会生成格式化的引用条目,通常包括:
- 标题(可点击链接)
- 来源网站信息
- 作者和日期信息
- 分类标签(如有)
注意事项
- 请确保引用来源的合法性
- 尊重原作者的版权声明
- 对于付费内容,建议注明访问权限要求
- 定期检查链接有效性,避免出现死链
如需进一步定制引用样式,请联系系统管理员获取组件样式修改指南。