feat: add Header, CHeader, and CppHeader components

Author: Lancern

src/components/CHeader.astro

@@ -0,0 +1,8 @@
+---
+import Header from "./Header.astro";
+import type { Props as HeaderProps } from "./Header.astro";
+
+type Props = Omit<HeaderProps, "lang">;
+---
+
+<Header lang="C" {...Astro.props} />

src/components/CppHeader.astro

@@ -0,0 +1,8 @@
+---
+import Header from "./Header.astro";
+import type { Props as HeaderProps } from "./Header.astro";
+
+type Props = Omit<HeaderProps, "lang">;
+---
+
+<Header lang="C++" {...Astro.props} />

src/components/Header.astro

@@ -0,0 +1,24 @@
+---
+import type { Language } from "@src/types";
+import DocLink from "./DocLink.astro";
+
+export interface Props {
+  lang: Language;
+  name: string;
+  displayName?: string;
+  nolink?: boolean;
+}
+
+const { lang, name, displayName, nolink } = Astro.props;
+const dest = `${lang}.headers.${name}`;
+
+const extension = lang === "C" ? ".h" : "";
+const text = displayName ?? `<${name}${extension}>`;
+
+const As = nolink ? Fragment : DocLink;
+const asProps = nolink ? {} : { dest };
+---
+
+<As {...asProps}>
+  <code>{text}</code>
+</As>

src/content/docs/c/library/headers/index.mdx

@@ -5,6 +5,7 @@ cppdoc:
   keys: ["c.library.headers"]
 ---
 
+import CHeader from "@components/CHeader.astro";
 import FeatureTestMacro, {
   FeatureTestMacroValue
 } from "@components/FeatureTestMacro.astro";
@@ -14,43 +15,43 @@ import Revision from "@components/Revision.astro";
 The interface of C standard library is defined by the following collection of headers.
 
 <dl>
-  <dt><Missing>`<assert.h>`</Missing></dt>
+  <dt><CHeader name="assert" /></dt>
   <dd>Conditionally compiled macro that compares its argument to zero</dd>
 
-  <dt><Revision noborder since="C99"><Missing>`<complex.h>`</Missing></Revision></dt>
+  <dt><Revision noborder since="C99"><CHeader name="complex" /></Revision></dt>
   <dd>Complex number arithmetic</dd>
 
-  <dt><Missing>`<ctype.h>`</Missing></dt>
+  <dt><CHeader name="ctype" /></dt>
   <dd>Functions to determine the type contained in character data</dd>
 
-  <dt><Missing>`<errno.h>`</Missing></dt>
+  <dt><CHeader name="errno" /></dt>
   <dd>Macros reporting error conditions</dd>
 
-  <dt><Revision noborder since="C99"><Missing>`<fenv.h>`</Missing></Revision></dt>
+  <dt><Revision noborder since="C99"><CHeader name="fenv" /></Revision></dt>
   <dd>Floating-point environment</dd>
 
-  <dt><Missing>`<float.h>`</Missing></dt>
+  <dt><CHeader name="float" /></dt>
   <dd>Limits of floating-point types</dd>
 
-  <dt><Revision noborder since="C99"><Missing>`<inttypes.h>`</Missing></Revision></dt>
+  <dt><Revision noborder since="C99"><CHeader name="inttypes" /></Revision></dt>
   <dd>Format conversion of integer types</dd>
 
-  <dt><Revision noborder since="C95"><Missing>`<iso646.h>`</Missing></Revision></dt>
+  <dt><Revision noborder since="C95"><CHeader name="iso646" /></Revision></dt>
   <dd>Alternative operator spellings</dd>
 
-  <dt><Missing>`<limits.h>`</Missing></dt>
+  <dt><CHeader name="limits" /></dt>
   <dd>Ranges of integer types</dd>
 
-  <dt><Missing>`<locale.h>`</Missing></dt>
+  <dt><CHeader name="locale" /></dt>
   <dd>Localization utilities</dd>
 
-  <dt><Missing>`<math.h>`</Missing></dt>
+  <dt><CHeader name="math" /></dt>
   <dd>Common mathematics functions</dd>
 
-  <dt><Missing>`<setjmp.h>`</Missing></dt>
+  <dt><CHeader name="setjmp" /></dt>
   <dd>Nonlocal jumps</dd>
 
-  <dt><Missing>`<signal.h>`</Missing></dt>
+  <dt><CHeader name="signal" /></dt>
   <dd>Signal handling</dd>
 
   <dt>
@@ -59,18 +60,18 @@ The interface of C standard library is defined by the following collection of he
       since="C11"
       traits={[ { trait: "deprecated", since: "C23" } ]}
     >
-      <Missing>`<signal.h>`</Missing>
+      <CHeader name="signal" />
     </Revision>
   </dt>
   <dd>alignas and alignof convenience macros</dd>
 
-  <dt><Missing>`<stdarg.h>`</Missing></dt>
+  <dt><CHeader name="stdarg" /></dt>
   <dd>Variable arguments</dd>
 
-  <dt><Revision noborder since="C11"><Missing>`<stdatomic.h>`</Missing></Revision></dt>
+  <dt><Revision noborder since="C11"><CHeader name="stdatomic" /></Revision></dt>
   <dd>Atomic operations</dd>
 
-  <dt><Revision noborder since="C23"><Missing>`<stdbit.h>`</Missing></Revision></dt>
+  <dt><Revision noborder since="C23"><CHeader name="stdbit" /></Revision></dt>
   <dd>Macros to work with the byte and bit representations of types</dd>
 
   <dt>
@@ -79,27 +80,27 @@ The interface of C standard library is defined by the following collection of he
       since="C99"
       traits={[ { trait: "deprecated", since: "C23" } ]}
     >
-      <Missing>`<stdbool.h>`</Missing>
+      <CHeader name="stdbool" />
     </Revision>
   </dt>
   <dd>Macros for boolean type</dd>
 
-  <dt><Revision noborder since="C23"><Missing>`<stdckdint.h>`</Missing></Revision></dt>
+  <dt><Revision noborder since="C23"><CHeader name="stdckdint" /></Revision></dt>
   <dd>Macros for performing checked integer arithmetic</dd>
 
-  <dt><Missing>`<stddef.h>`</Missing></dt>
+  <dt><CHeader name="stddef" /></dt>
   <dd>Common macro definitions</dd>
 
-  <dt><Revision noborder since="C99"><Missing>`<stdint.h>`</Missing></Revision></dt>
+  <dt><Revision noborder since="C99"><CHeader name="stdint" /></Revision></dt>
   <dd>Fixed-width integer types</dd>
 
-  <dt><Missing>`<stdio.h>`</Missing></dt>
+  <dt><CHeader name="stdio" /></dt>
   <dd>Input/output</dd>
 
-  <dt><Missing>`<stdlib.h>`</Missing></dt>
+  <dt><CHeader name="stdlib" /></dt>
   <dd>General utilities: <Missing>memory management</Missing>, <Missing>program utilities</Missing>, <Missing>string conversions</Missing>, <Missing>random numbers</Missing>, <Missing>algorithms</Missing></dd>
 
-  <dt><Revision noborder since="C29"><Missing>`<stdmchar.h>`</Missing></Revision></dt>
+  <dt><Revision noborder since="C29"><CHeader name="stdmchar" /></Revision></dt>
   <dd>Text transcode</dd>
 
   <dt>
@@ -108,164 +109,164 @@ The interface of C standard library is defined by the following collection of he
       since="C11"
       traits={[ { trait: "deprecated", since: "C23" } ]}
     >
-      <Missing>`<stdnoreturn.h>`</Missing>
+      <CHeader name="stdnoreturn" />
     </Revision>
   </dt>
   <dd><Missing>noreturn</Missing> convenience macro</dd>
 
-  <dt><Missing>`<string.h>`</Missing></dt>
+  <dt><CHeader name="string" /></dt>
   <dd>String handling</dd>
 
-  <dt><Revision noborder since="C99"><Missing>`<tgmath.h>`</Missing></Revision></dt>
-  <dd>Type-generic math (macros wrapping <Missing>`<math.h>`</Missing> and <Missing>`<complex.h>`</Missing>)</dd>
+  <dt><Revision noborder since="C99"><CHeader name="tgmath" /></Revision></dt>
+  <dd>Type-generic math (macros wrapping <CHeader name="math" /> and <CHeader name="complex" />)</dd>
 
-  <dt><Revision noborder since="C11"><Missing>`<threads.h>`</Missing></Revision></dt>
+  <dt><Revision noborder since="C11"><CHeader name="threads" /></Revision></dt>
   <dd>Thread library</dd>
 
-  <dt><Missing>`<time.h>`</Missing></dt>
+  <dt><CHeader name="time" /></dt>
   <dd>Time/date utilities</dd>
 
-  <dt><Revision noborder since="C11"><Missing>`<uchar.h>`</Missing></Revision></dt>
+  <dt><Revision noborder since="C11"><CHeader name="uchar" /></Revision></dt>
   <dd>UTF-16 and UTF-32 character utilities</dd>
 
-  <dt><Revision noborder since="C95"><Missing>`<wchar.h>`</Missing></Revision></dt>
+  <dt><Revision noborder since="C95"><CHeader name="wchar" /></Revision></dt>
   <dd>Extended multibyte and wide character utilities</dd>
 
-  <dt><Revision noborder since="C95"><Missing>`<wctype.h>`</Missing></Revision></dt>
+  <dt><Revision noborder since="C95"><CHeader name="wctype" /></Revision></dt>
   <dd>Functions to determine the type contained in wide character data</dd>
 </dl>
 
 ## Feature test macros :badge[C23]
 
 <FeatureTestMacro name="__STDC_VERSION_ASSERT_H__">
   <FeatureTestMacroValue value="202311L" since="C23">
-    <Missing>`<assert.h>`</Missing>
+    <CHeader name="assert" />
   </FeatureTestMacroValue>
 </FeatureTestMacro>
 
 <FeatureTestMacro name="__STDC_VERSION_COMPLEX_H__">
   <FeatureTestMacroValue value="202311L" since="C23">
-    <Missing>`<complex.h>`</Missing>
+    <CHeader name="complex" />
   </FeatureTestMacroValue>
 </FeatureTestMacro>
 
 <FeatureTestMacro name="__STDC_VERSION_FENV_H__">
   <FeatureTestMacroValue value="202311L" since="C23">
-    <Missing>`<fenv.h>`</Missing>
+    <CHeader name="fenv" />
   </FeatureTestMacroValue>
 </FeatureTestMacro>
 
 <FeatureTestMacro name="__STDC_VERSION_FLOAT_H__">
   <FeatureTestMacroValue value="202311L" since="C23">
-    <Missing>`<float.h>`</Missing>
+    <CHeader name="float" />
   </FeatureTestMacroValue>
 </FeatureTestMacro>
 
 <FeatureTestMacro name="__STDC_VERSION_INTTYPES_H__">
   <FeatureTestMacroValue value="202311L" since="C23">
-    <Missing>`<inttypes.h>`</Missing>
+    <CHeader name="inttypes" />
   </FeatureTestMacroValue>
 </FeatureTestMacro>
 
 <FeatureTestMacro name="__STDC_VERSION_LIMITS_H__">
   <FeatureTestMacroValue value="202311L" since="C23">
-    <Missing>`<limits.h>`</Missing>
+    <CHeader name="limits" />
   </FeatureTestMacroValue>
 </FeatureTestMacro>
 
 <FeatureTestMacro name="__STDC_VERSION_MATH_H__">
   <FeatureTestMacroValue value="202311L" since="C23">
-    <Missing>`<math.h>`</Missing>
+    <CHeader name="math" />
   </FeatureTestMacroValue>
 </FeatureTestMacro>
 
 <FeatureTestMacro name="__STDC_VERSION_SETJMP_H__">
   <FeatureTestMacroValue value="202311L" since="C23">
-    <Missing>`<setjmp.h>`</Missing>
+    <CHeader name="setjmp" />
   </FeatureTestMacroValue>
 </FeatureTestMacro>
 
 <FeatureTestMacro name="__STDC_VERSION_STDARG_H__">
   <FeatureTestMacroValue value="202311L" since="C23">
-    <Missing>`<stdarg.h>`</Missing>
+    <CHeader name="stdarg" />
   </FeatureTestMacroValue>
 </FeatureTestMacro>
 
 <FeatureTestMacro name="__STDC_VERSION_STDATOMIC_H__">
   <FeatureTestMacroValue value="202311L" since="C23">
-    <Missing>`<stdatomic.h>`</Missing>
+    <CHeader name="stdatomic" />
   </FeatureTestMacroValue>
 </FeatureTestMacro>
 
 <FeatureTestMacro name="__STDC_VERSION_STDBIT_H__">
   <FeatureTestMacroValue value="202311L" since="C23">
-    <Missing>`<stdbit.h>`</Missing>
+    <CHeader name="stdbit" />
   </FeatureTestMacroValue>
 </FeatureTestMacro>
 
 <FeatureTestMacro name="__STDC_VERSION_STDCKDINT_H__">
   <FeatureTestMacroValue value="202311L" since="C23">
-    <Missing>`<stdckdint.h>`</Missing>
+    <CHeader name="stdckdint" />
   </FeatureTestMacroValue>
 </FeatureTestMacro>
 
 <FeatureTestMacro name="__STDC_VERSION_STDDEF_H__">
   <FeatureTestMacroValue value="202311L" since="C23">
-    <Missing>`<stddef.h>`</Missing>
+    <CHeader name="stddef" />
   </FeatureTestMacroValue>
 </FeatureTestMacro>
 
 <FeatureTestMacro name="__STDC_VERSION_STDINT_H__">
   <FeatureTestMacroValue value="202311L" since="C23">
-    <Missing>`<stdint.h>`</Missing>
+    <CHeader name="stdint" />
   </FeatureTestMacroValue>
 </FeatureTestMacro>
 
 <FeatureTestMacro name="__STDC_VERSION_STDIO_H__">
   <FeatureTestMacroValue value="202311L" since="C23">
-    <Missing>`<stdio.h>`</Missing>
+    <CHeader name="stdio" />
   </FeatureTestMacroValue>
 </FeatureTestMacro>
 
 <FeatureTestMacro name="__STDC_VERSION_STDLIB_H__">
   <FeatureTestMacroValue value="202311L" since="C23">
-    <Missing>`<stdlib.h>`</Missing>
+    <CHeader name="stdlib" />
   </FeatureTestMacroValue>
 </FeatureTestMacro>
 
 <FeatureTestMacro name="__STDC_VERSION_STDMCHAR_H__">
   <FeatureTestMacroValue value="202311L" since="C23">
-    <Missing>`<stdmchar.h>`</Missing>
+    <CHeader name="stdmchar" />
   </FeatureTestMacroValue>
 </FeatureTestMacro>
 
 <FeatureTestMacro name="__STDC_VERSION_STRING_H__">
   <FeatureTestMacroValue value="202311L" since="C23">
-    <Missing>`<string.h>`</Missing>
+    <CHeader name="string" />
   </FeatureTestMacroValue>
 </FeatureTestMacro>
 
 <FeatureTestMacro name="__STDC_VERSION_TGMATH_H__">
   <FeatureTestMacroValue value="202311L" since="C23">
-    <Missing>`<tgmath.h>`</Missing>
+    <CHeader name="tgmath" />
   </FeatureTestMacroValue>
 </FeatureTestMacro>
 
 <FeatureTestMacro name="__STDC_VERSION_TIME_H__">
   <FeatureTestMacroValue value="202311L" since="C23">
-    <Missing>`<time.h>`</Missing>
+    <CHeader name="time" />
   </FeatureTestMacroValue>
 </FeatureTestMacro>
 
 <FeatureTestMacro name="__STDC_VERSION_UCHAR_H__">
   <FeatureTestMacroValue value="202311L" since="C23">
-    <Missing>`<uchar.h>`</Missing>
+    <CHeader name="uchar" />
   </FeatureTestMacroValue>
 </FeatureTestMacro>
 
 <FeatureTestMacro name="__STDC_VERSION_WCHAR_H__">
   <FeatureTestMacroValue value="202311L" since="C23">
-    <Missing>`<wchar.h>`</Missing>
+    <CHeader name="wchar" />
   </FeatureTestMacroValue>
 </FeatureTestMacro>