Skip to content
Draft

Roam01 #1207

Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -3,13 +3,15 @@ import { useMDXComponents } from "mdx-components";

type DocsPageTemplateProps = Omit<EvaluateResult, "default"> & {
children: React.ReactNode;
isUseCasePage?: boolean;
};

const hasPrimaryHeading = (sourceCode: string): boolean =>
/(^|\n)#\s+\S/m.test(sourceCode);

const DocsPageTemplate = ({
children,
isUseCasePage,
metadata,
sourceCode,
...wrapperProps
Expand All @@ -25,7 +27,11 @@ const DocsPageTemplate = ({
return (
<Wrapper metadata={metadata} sourceCode={sourceCode} {...wrapperProps}>
{!hasPrimaryHeading(sourceCode) && <H1>{metadata.title}</H1>}
{children}
{isUseCasePage ? (
<div className="use-case-content">{children}</div>
) : (
children
)}
</Wrapper>
);
};
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -39,7 +39,10 @@ const Page = async ({ params }: DocsPageProps): Promise<React.ReactElement> => {
const { default: MDXContent, ...wrapperProps } = result;

return (
<DocsPageTemplate {...wrapperProps}>
<DocsPageTemplate
{...wrapperProps}
isUseCasePage={mdxPath?.[0] === "use-cases"}
>
<MDXContent params={{ mdxPath: mdxPath ?? [] }} />
</DocsPageTemplate>
);
Expand Down
20 changes: 12 additions & 8 deletions apps/website/app/(docs)/docs/obsidian/navigation.ts
Original file line number Diff line number Diff line change
Expand Up @@ -67,6 +67,10 @@ export const navigation: NavigationList = [
title: "Querying your discourse graph",
href: `${ROOT}/querying-discourse-graph`,
},
{
title: "Experiment tracking",
href: `${ROOT}/experiment-tracking`,
},
],
},

Expand All @@ -83,20 +87,20 @@ export const navigation: NavigationList = [
title: "🚢 Use cases",
links: [
{
title: "Literature review",
href: `${ROOT}/literature-reviewing`,
title: "Build and Utilize a Personal Knowledge Base",
href: `${ROOT}/build-utilize-personal-knowledge-base`,
},
{
title: "Research notes",
href: `${ROOT}/research-roadmapping`,
title: "Synthesize Insights from the Literature",
href: `${ROOT}/synthesize-insights-from-literature`,
},
{
title: "Reading clubs & seminars",
href: `${ROOT}/reading-clubs`,
title: "Share your ideas & research",
href: `${ROOT}/share-your-ideas-and-research`,
},
{
title: "Lab notebooks",
href: `${ROOT}/lab-notebooks`,
title: "Track your Projects and Experiments",
href: `${ROOT}/track-your-projects-and-experiments`,
},
],
},
Expand Down
5 changes: 4 additions & 1 deletion apps/website/app/(docs)/docs/roam/[[...mdxPath]]/page.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -39,7 +39,10 @@ const Page = async ({ params }: DocsPageProps): Promise<React.ReactElement> => {
const { default: MDXContent, ...wrapperProps } = result;

return (
<DocsPageTemplate {...wrapperProps}>
<DocsPageTemplate
{...wrapperProps}
isUseCasePage={mdxPath?.[0] === "use-cases"}
>
<MDXContent params={{ mdxPath: mdxPath ?? [] }} />
</DocsPageTemplate>
);
Expand Down
24 changes: 12 additions & 12 deletions apps/website/app/(docs)/docs/roam/navigation.ts
Original file line number Diff line number Diff line change
Expand Up @@ -49,6 +49,10 @@ export const navigation: NavigationList = [
title: "Sharing",
href: `${ROOT}/sharing-discourse-graph`,
},
{
title: "Experiment tracking",
href: `${ROOT}/experiment-tracking`,
},
],
},
{
Expand All @@ -68,24 +72,20 @@ export const navigation: NavigationList = [
title: "🚢 Use cases",
links: [
{
title: "Literature reviewing",
href: `${ROOT}/literature-reviewing`,
},
{
title: "Zettelkasten",
href: `${ROOT}/enhanced-zettelkasten`,
title: "Build and Utilize a Personal Knowledge Base",
href: `${ROOT}/build-utilize-personal-knowledge-base`,
},
{
title: "Reading clubs / seminars",
href: `${ROOT}/reading-clubs`,
title: "Synthesize Insights from the Literature",
href: `${ROOT}/synthesize-insights-from-literature`,
},
{
title: "Lab notebooks",
href: `${ROOT}/lab-notebooks`,
title: "Share your ideas & research",
href: `${ROOT}/share-your-ideas-and-research`,
},
{
title: "Product / research roadmapping",
href: `${ROOT}/research-roadmapping`,
title: "Track your Projects and Experiments",
href: `${ROOT}/track-your-projects-and-experiments`,
},
],
},
Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
---
title: "Build and Utilize a Personal Knowledge Base"
date: "2026-06-29"
author: ""
published: true
---

Description coming soon!
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
---
title: "Experiment Tracking"
date: "2026-06-29"
author: ""
published: true
---

TODO: Add content for this guide.
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "Lab notebooks"
date: "2025-01-01"
title: "Share your ideas & research"
date: "2026-06-29"
author: ""
published: true
---
Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
---
title: "Synthesize Insights from the Literature"
date: "2026-06-29"
author: ""
published: true
---

Description coming soon!
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
---
title: "Track your Projects and Experiments"
date: "2026-06-29"
author: ""
published: true
---

Description coming soon!
98 changes: 98 additions & 0 deletions apps/website/app/(nextra)/nextra-css.css
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,104 @@
--nextra-content-width: 90rem;
}

.use-case-content img {
border: 1px solid #cbcbcb;
}

/* Node tags — soft pill: tinted background, colored border/text, matching
the candidate-tag styling from the Roam graph's roam/css (screenshots).
hyp/clm share green and evd/res share red since the docs treat those pairs
as equivalent (Results Graph vs. Discourse Graph dialect). */
.node-tag {
display: inline-block;
padding: 1px 10px;
border-radius: 999px;
font-size: 0.85em;
font-weight: 500;
white-space: nowrap;
background-color: color-mix(in srgb, var(--node-tag-color, #adb5bd) 15%, transparent);
border: 1px solid color-mix(in srgb, var(--node-tag-color, #adb5bd) 45%, transparent);
color: color-mix(in srgb, var(--node-tag-color, #adb5bd) 75%, #000);
}

.node-tag[data-type="que"] {
--node-tag-color: #e8590c;
}
.node-tag[data-type="hyp"] {
--node-tag-color: #40c057;
}
.node-tag[data-type="evd"] {
--node-tag-color: #e03131;
}
.node-tag[data-type="res"] {
--node-tag-color: #e03131;
}
.node-tag[data-type="clm"] {
--node-tag-color: #40c057;
}
.node-tag[data-type="iss"] {
--node-tag-color: #ae3ec9;
}
.node-tag[data-type="src"] {
--node-tag-color: #495057;
}

/* Callouts */
.callout {
border: 1px solid color-mix(in srgb, var(--callout-color) 30%, transparent);
border-left: 4px solid var(--callout-color);
border-radius: 6px;
margin: 1.25rem 0;
overflow: hidden;
}

.callout-title {
display: flex;
align-items: center;
gap: 8px;
padding: 8px 14px;
background: color-mix(in srgb, var(--callout-color) 12%, transparent);
font-weight: 600;
font-size: 0.9em;
color: color-mix(in srgb, var(--callout-color) 60%, #000);
}

.callout-title-text {
flex: 1;
min-width: 0;
}

.callout-fold {
margin-left: auto;
transition: transform 0.2s ease;
opacity: 0.7;
}

details.callout[open] .callout-fold {
transform: rotate(180deg);
}

details.callout > summary {
cursor: pointer;
list-style: none;
}

details.callout > summary::-webkit-details-marker {
display: none;
}

.callout-body {
padding: 10px 14px;
font-size: 0.9em;
}

.callout-body > *:first-child {
margin-top: 0;
}
.callout-body > *:last-child {
margin-bottom: 0;
}

html:not(.dark) .nextra-search-results a {
color: #1f1f1f !important;
}
Expand Down
11 changes: 7 additions & 4 deletions apps/website/content/obsidian/use-cases/_meta.ts
Original file line number Diff line number Diff line change
@@ -1,10 +1,13 @@
import type { MetaRecord } from "nextra";

const meta: MetaRecord = {
"literature-reviewing": "Literature review",
"research-roadmapping": "Research notes",
"reading-clubs": "Reading clubs and seminars",
"lab-notebooks": "Lab notebooks",
"build-utilize-personal-knowledge-base":
"Build and Utilize a Personal Knowledge Base",
"synthesize-insights-from-literature":
"Synthesize Insights from the Literature",
"share-your-ideas-and-research": "Share your ideas & research",
"track-your-projects-and-experiments": "Track your Projects and Experiments",
"experiment-tracking": "Experiment Tracking",
};

export default meta;
Loading