TemplateRegistry.php 2.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081
  1. <?php
  2. namespace App\Services\Markup\Templates;
  3. /**
  4. * 模板名 → 模板类。别名直接登记成另一个名字。
  5. *
  6. * 新增模板:写一个 {@see Template} 子类,在这里加一行。
  7. */
  8. final class TemplateRegistry
  9. {
  10. /** @var array<string, class-string<Template>> */
  11. private const TEMPLATES = [
  12. 'term' => TermTemplate::class,
  13. 'note' => NoteTemplate::class,
  14. 'n' => NoteTemplate::class,
  15. 'sent' => SentTemplate::class,
  16. 'quote' => QuoteTemplate::class,
  17. 'ql' => QuoteLinkTemplate::class,
  18. 'exercise' => ExerciseTemplate::class,
  19. 'article' => ArticleTemplate::class,
  20. 'nissaya' => NissayaTemplate::class,
  21. 'mermaid' => MermaidTemplate::class,
  22. 'qa' => QaTemplate::class,
  23. 'v' => VideoTemplate::class,
  24. 'g' => GrammarTemplate::class,
  25. 'ref' => ReferenceTemplate::class,
  26. 'dict-pref' => DictPrefTemplate::class,
  27. 'ai' => AiTemplate::class,
  28. 'para' => ParaTemplate::class,
  29. 'category' => CategoryTemplate::class,
  30. 'quality' => QualityTemplate::class,
  31. 'toggle' => ToggleTemplate::class,
  32. 'toc' => TocTemplate::class,
  33. ];
  34. /**
  35. * 内部模板:只由程序生成(批注注入),不在源码语法里——正文里写 `{{anno-issue|…}}` 得到的是 unknown。
  36. *
  37. * @var array<string, class-string<Template>>
  38. */
  39. private const INTERNAL = [
  40. 'anno-issue' => Internal\AnnoIssueTemplate::class,
  41. 'anno-issue-mark' => Internal\AnnoIssueMarkTemplate::class,
  42. 'anno-assessment' => Internal\AnnoAssessmentTemplate::class,
  43. ];
  44. /** `{{Tpl:名字|…}}`:以文章为模板(标题就是模板名) */
  45. public const TPL_PREFIX = 'Tpl:';
  46. /** @var array<class-string<Template>, Template> */
  47. private array $instances = [];
  48. public function get(string $name): Template
  49. {
  50. $class = self::TEMPLATES[$name] ?? null;
  51. if ($class === null) {
  52. $class = str_starts_with($name, self::TPL_PREFIX) ? TplTemplate::class : UnknownTemplate::class;
  53. }
  54. return $this->instances[$class] ??= app($class);
  55. }
  56. /**
  57. * 内部模板({@see self::INTERNAL});不是内部模板名时退回 {@see self::get()}。
  58. */
  59. public function internal(string $name): Template
  60. {
  61. $class = self::INTERNAL[$name] ?? null;
  62. return $class === null ? $this->get($name) : ($this->instances[$class] ??= app($class));
  63. }
  64. /**
  65. * @return list<string>
  66. */
  67. public function names(): array
  68. {
  69. return array_keys(self::TEMPLATES);
  70. }
  71. }