TemplateRegistry.php 2.5 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980
  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. ];
  33. /**
  34. * 内部模板:只由程序生成(批注注入),不在源码语法里——正文里写 `{{anno-issue|…}}` 得到的是 unknown。
  35. *
  36. * @var array<string, class-string<Template>>
  37. */
  38. private const INTERNAL = [
  39. 'anno-issue' => Internal\AnnoIssueTemplate::class,
  40. 'anno-issue-mark' => Internal\AnnoIssueMarkTemplate::class,
  41. 'anno-assessment' => Internal\AnnoAssessmentTemplate::class,
  42. ];
  43. /** `{{Tpl:名字|…}}`:以文章为模板(标题就是模板名) */
  44. public const TPL_PREFIX = 'Tpl:';
  45. /** @var array<class-string<Template>, Template> */
  46. private array $instances = [];
  47. public function get(string $name): Template
  48. {
  49. $class = self::TEMPLATES[$name] ?? null;
  50. if ($class === null) {
  51. $class = str_starts_with($name, self::TPL_PREFIX) ? TplTemplate::class : UnknownTemplate::class;
  52. }
  53. return $this->instances[$class] ??= app($class);
  54. }
  55. /**
  56. * 内部模板({@see self::INTERNAL});不是内部模板名时退回 {@see self::get()}。
  57. */
  58. public function internal(string $name): Template
  59. {
  60. $class = self::INTERNAL[$name] ?? null;
  61. return $class === null ? $this->get($name) : ($this->instances[$class] ??= app($class));
  62. }
  63. /**
  64. * @return list<string>
  65. */
  66. public function names(): array
  67. {
  68. return array_keys(self::TEMPLATES);
  69. }
  70. }