docs.css 5.9 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326
  1. /*
  2. * Public client handbook. Deliberately close to client-package/docs/assets/docs.css
  3. * so all three viewers look like the same product; the additions here are the
  4. * index lists, the source note and the hint that only machines read.
  5. */
  6. :root {
  7. color-scheme: light;
  8. --docs-bg: #f5f6f8;
  9. --docs-surface: #fff;
  10. --docs-text: #1a1a1a;
  11. --docs-muted: #5c6370;
  12. --docs-accent: #003366;
  13. --docs-border: #d8dde6;
  14. --docs-code-bg: #eef1f5;
  15. font-family: system-ui, -apple-system, "Segoe UI", Roboto, sans-serif;
  16. line-height: 1.6;
  17. }
  18. *,
  19. *::before,
  20. *::after {
  21. box-sizing: border-box;
  22. }
  23. body {
  24. margin: 0;
  25. background: var(--docs-bg);
  26. color: var(--docs-text);
  27. }
  28. /*
  29. * The pointer to the Markdown rendering. It is in the markup, not in a comment
  30. * alone, so that a program extracting text from this page finds it; a reader
  31. * never sees it.
  32. */
  33. .llm-only {
  34. display: none;
  35. }
  36. .docs-header {
  37. background: var(--docs-accent);
  38. color: #fff;
  39. }
  40. .docs-header-inner {
  41. max-width: 72rem;
  42. margin: 0 auto;
  43. padding: 0.75rem 1.25rem;
  44. display: flex;
  45. align-items: baseline;
  46. justify-content: space-between;
  47. gap: 1rem;
  48. flex-wrap: wrap;
  49. }
  50. .docs-brand {
  51. color: inherit;
  52. text-decoration: none;
  53. font-weight: 600;
  54. }
  55. .docs-brand:hover {
  56. text-decoration: underline;
  57. }
  58. .docs-header-links {
  59. display: flex;
  60. gap: 1rem;
  61. font-size: 0.9rem;
  62. }
  63. .docs-header-links a {
  64. color: inherit;
  65. opacity: 0.9;
  66. }
  67. .docs-layout {
  68. max-width: 72rem;
  69. margin: 0 auto;
  70. padding: 1.25rem;
  71. display: grid;
  72. grid-template-columns: minmax(13rem, 17rem) 1fr;
  73. gap: 1.5rem;
  74. align-items: start;
  75. }
  76. @media (max-width: 900px) {
  77. .docs-layout {
  78. grid-template-columns: 1fr;
  79. }
  80. .docs-nav {
  81. position: static;
  82. max-height: none;
  83. }
  84. }
  85. .docs-nav {
  86. background: var(--docs-surface);
  87. border: 1px solid var(--docs-border);
  88. border-radius: 0.5rem;
  89. padding: 1rem;
  90. position: sticky;
  91. top: 1rem;
  92. max-height: calc(100vh - 2rem);
  93. overflow-y: auto;
  94. }
  95. .docs-nav-title {
  96. margin: 1.1rem 0 0.4rem;
  97. font-size: 0.7rem;
  98. text-transform: uppercase;
  99. letter-spacing: 0.06em;
  100. color: var(--docs-muted);
  101. }
  102. .docs-nav-title:first-child {
  103. margin-top: 0;
  104. }
  105. .docs-nav ul {
  106. margin: 0;
  107. padding: 0;
  108. list-style: none;
  109. }
  110. .docs-nav li + li {
  111. margin-top: 0.15rem;
  112. }
  113. .docs-nav a {
  114. display: block;
  115. padding: 0.3rem 0.45rem;
  116. border-radius: 0.25rem;
  117. color: var(--docs-accent);
  118. text-decoration: none;
  119. font-size: 0.88rem;
  120. overflow-wrap: anywhere;
  121. }
  122. .docs-nav a:hover {
  123. background: var(--docs-code-bg);
  124. }
  125. .docs-nav a[aria-current="page"] {
  126. background: var(--docs-accent);
  127. color: #fff;
  128. }
  129. .docs-nav-code a {
  130. font-family: ui-monospace, "Cascadia Code", "Source Code Pro", monospace;
  131. font-size: 0.78rem;
  132. }
  133. .docs-main {
  134. background: var(--docs-surface);
  135. border: 1px solid var(--docs-border);
  136. border-radius: 0.5rem;
  137. padding: 1.5rem 2rem;
  138. min-width: 0;
  139. }
  140. .docs-main > h1:first-child {
  141. margin-top: 0;
  142. }
  143. .docs-main h2 {
  144. margin-top: 2rem;
  145. padding-bottom: 0.2em;
  146. border-bottom: 1px solid var(--docs-border);
  147. }
  148. /* Index: page name plus the one line that says what is on it. */
  149. .docs-index-list {
  150. margin: 0.75rem 0 0;
  151. }
  152. .docs-index-list dt {
  153. margin-top: 0.9rem;
  154. display: flex;
  155. align-items: baseline;
  156. gap: 0.6rem;
  157. }
  158. .docs-index-list dt a {
  159. color: var(--docs-accent);
  160. font-weight: 600;
  161. }
  162. .docs-index-list dd {
  163. margin: 0.1rem 0 0;
  164. color: var(--docs-muted);
  165. font-size: 0.92rem;
  166. }
  167. .docs-index-code dt a {
  168. font-family: ui-monospace, "Cascadia Code", "Source Code Pro", monospace;
  169. font-size: 0.88rem;
  170. font-weight: 500;
  171. }
  172. .docs-size {
  173. color: var(--docs-muted);
  174. font-size: 0.78rem;
  175. white-space: nowrap;
  176. }
  177. .docs-source-note {
  178. margin: 0 0 1.5rem;
  179. padding-bottom: 0.75rem;
  180. border-bottom: 1px solid var(--docs-border);
  181. color: var(--docs-muted);
  182. font-size: 0.85rem;
  183. }
  184. .docs-source-note a {
  185. color: var(--docs-accent);
  186. }
  187. .markdown-body h1,
  188. .markdown-body h2,
  189. .markdown-body h3,
  190. .markdown-body h4 {
  191. line-height: 1.25;
  192. margin-top: 1.6em;
  193. margin-bottom: 0.5em;
  194. }
  195. .markdown-body h1:first-child {
  196. margin-top: 0;
  197. }
  198. .markdown-body h2 {
  199. padding-bottom: 0.2em;
  200. border-bottom: 1px solid var(--docs-border);
  201. }
  202. .markdown-body p,
  203. .markdown-body ul,
  204. .markdown-body ol,
  205. .markdown-body pre,
  206. .markdown-body table {
  207. margin: 0.75em 0;
  208. }
  209. .markdown-body a {
  210. color: var(--docs-accent);
  211. }
  212. .markdown-body code {
  213. font-family: ui-monospace, "Cascadia Code", "Source Code Pro", monospace;
  214. font-size: 0.9em;
  215. background: var(--docs-code-bg);
  216. padding: 0.1em 0.35em;
  217. border-radius: 0.2em;
  218. }
  219. .markdown-body pre {
  220. background: var(--docs-code-bg);
  221. padding: 1rem;
  222. overflow-x: auto;
  223. border-radius: 0.35rem;
  224. line-height: 1.45;
  225. }
  226. .markdown-body pre code {
  227. padding: 0;
  228. background: none;
  229. font-size: 0.82rem;
  230. }
  231. .markdown-body table {
  232. border-collapse: collapse;
  233. width: 100%;
  234. font-size: 0.95rem;
  235. display: block;
  236. overflow-x: auto;
  237. }
  238. .markdown-body th,
  239. .markdown-body td {
  240. border: 1px solid var(--docs-border);
  241. padding: 0.4rem 0.6rem;
  242. text-align: left;
  243. }
  244. .markdown-body th {
  245. background: var(--docs-code-bg);
  246. }
  247. .markdown-body blockquote {
  248. margin: 1em 0;
  249. padding-left: 1em;
  250. border-left: 4px solid var(--docs-border);
  251. color: var(--docs-muted);
  252. }
  253. .markdown-body hr {
  254. border: 0;
  255. border-top: 1px solid var(--docs-border);
  256. margin: 2em 0;
  257. }
  258. .docs-note {
  259. background: var(--docs-code-bg);
  260. border-left: 4px solid var(--docs-accent);
  261. padding: 0.75rem 1rem;
  262. margin: 0 0 1.5rem;
  263. font-size: 0.9rem;
  264. }
  265. .docs-note p {
  266. margin: 0.25rem 0;
  267. }
  268. /* Swagger UI page: same frame, the widget brings its own styling. */
  269. .swagger-frame {
  270. max-width: 72rem;
  271. margin: 0 auto;
  272. padding: 1.25rem;
  273. }
  274. .swagger-frame .swagger-ui .topbar {
  275. display: none;
  276. }