结论:用编辑器工具栏的「引用书籍 / 书架 / 百科」按钮,或手写短代码即可。
① 书籍卡短代码是 [book=书籍ID,书籍ID],书架卡是 [shelf=用户ID],百科词条卡是 [baike=词条ID]。
② 卡片会校验访问权限,私密书、加密书或无权版块的内容不会被绕过展示。
③ 单条正文卡片数量有上限,书籍默认 6 个、书架 2 个、词条 3 个,以站点配置为准。
④ 该功能只在支持引用卡片的版块可用,发帖前确认所在版块是否开启。
帖子里怎么引用一本书或百科词条?
如题,希望有经验的朋友给一个能落地的解答。
结论:用编辑器工具栏的「引用书籍 / 书架 / 百科」按钮,或手写短代码即可。
① 书籍卡短代码是 [book=书籍ID,书籍ID],书架卡是 [shelf=用户ID],百科词条卡是 [baike=词条ID]。
② 卡片会校验访问权限,私密书、加密书或无权版块的内容不会被绕过展示。
③ 单条正文卡片数量有上限,书籍默认 6 个、书架 2 个、词条 3 个,以站点配置为准。
④ 该功能只在支持引用卡片的版块可用,发帖前确认所在版块是否开启。
【结论】能引,前提是发帖的版块支持引用卡片——编辑器工具栏里会有「引用书籍 / 书架 / 百科」按钮,点按钮挑书就行,手写短代码也能生效。
【展开】具体两条路:一是在支持的版块发帖或编辑时,直接用工具栏的引用按钮,选中书单库里的书或百科词条插进去;二是手动在正文写短代码,[book=书籍ID,书籍ID] 渲染书籍卡,[baike=词条ID] 渲染百科词条卡,[shelf=用户ID] 是书架卡。书籍 ID 和词条 ID 看对应详情页地址里那串数字,/book-{书籍ID}.html、词条页同理。
几个容易踩的点:不是所有版块都开了这个功能,普通版块里如果工具栏没有这几个按钮,基本就是没启用;卡片会校验访问权限,私密书、加密书或者你没权限看的内容,引用出来也不会绕过限制展示;单条正文的卡片数量有上限,书籍默认 6 个、书架 2 个、词条 3 个,具体以站点页面配置为准,塞太多可能加不进去。
另外帖子的「关联」是另一套东西,在开启的普通版块发帖或编辑时可以关联书单库书籍(可多本)和至多一个百科词条,关联内容会在帖子页结构化展示,能一键跳到书籍详情页或词条页。引用是插在正文里,关联是挂在帖子上的,看你想让读者在哪儿看到。
【建议】先随便开个草稿试一下按钮在不在,能点出来就照着选;找不到入口的话,去 /guide.html 站点功能导览翻一眼,或者直接发帖问版块里的老哥。
老书虫:【结论】能引,前提是发帖的版块支持引用卡片——编辑器工具栏里会有「引用书籍 / 书架 / 百科」按钮,点按钮挑书就行,手写短代码也能生效。 【展开】具体两条路…
老书虫这条说得挺全,我补两个实操细节,免得试的时候白折腾。
第一,短代码里多本书确实是用英文逗号隔开写在一对方括号里,别用中文逗号,也别分开写多个 [book=...],不然容易渲染不出来。第二,书籍 ID 就在详情页地址 /book-{书籍ID}.html 那串数字里,词条 ID 同理,从词条页地址里取,比在页面里翻省事。
另外提醒一句,“引用”和“关联”这两个上限别混着记:正文卡片是书籍默认 6 个、书架 2 个、词条 3 个;帖子关联是书籍默认 6 个、词条 3 个。想让人点一下就跳过去,用关联更清爽;想在正文里边讲边带出书卡,就用引用。建议先开个草稿贴试试按钮和预览效果,渲染正常了再发正式帖,省得改来改去。