roam/js | notes | kipras melnikovas

roam/js

words:	34 + 1675 = 1709
last update:

#public
lots of learnings in [[January 4th, 2022]]
{{[[roam/js]]}}
- ```javascript console.log("yay roam/js works!") //document.body.style.color = "red !important" var blockLines = document.querySelectorAll(".rm-multibar") // window.roamAlphaAPI.q("") blockLines.forEach(bar => { // bar.style["border-right-width"] = "2px" // bar.style["border-color"] = "hsl(135,100%,44%)" }) ```
[[(hidden) p-dQYLa_l]]
- [[January 4th, 2022]]

Linked Mentions (9 in 7 pages)

roam/js (1)

{{[[roam/js]]}}
- ```javascript console.log("yay roam/js works!") //document.body.style.color = "red !important" var blockLines = document.querySelectorAll(".rm-multibar") // window.roamAlphaAPI.q("") blockLines.forEach(bar => { // bar.style["border-right-width"] = "2px" // bar.style["border-color"] = "hsl(135,100%,44%)" }) ```

July 10th, 2021 (1)

(hidden) EwjLbbWE0 [[(hidden) 140x0T4j5]] [[(hidden) zJw7j5jxr]] (hidden) WUvBQMQsn:: [[roam/js]]
- [[roam-traverse-graph]]
  - {{[[TODO]]}} how does roam parse this attribute (with spaces) and make it available as a symbol or what it's called `:foo`?
    - {{[[TODO]]}} could we use the same logic for cleaning up filenames so the urls are clean as well in [[export-html-pages]]?

January 4th, 2022 (2)

[[roam/js]] #public
- https://roamresearch.com/#[[(hidden) G97ohL3l8]]/app/developer-documentation/page/49715b-M2
  - roam/js
    - https://roamresearch.com/#[[(hidden) G97ohL3l8]]/app/developer-documentation/page/QE0bxjUwk
    - examples
      - https://roamresearch.com/#[[(hidden) G97ohL3l8]]/app/developer-documentation/page/0zhdQjUXs
        
        https://github.com/aidam38/roamsr/blob/master/src/main.js
        
        https://github.com/aidam38/roamsr/blob/b99fae9243d1e00db4571b5eafb8791d85592d5f/src/core/state.js#[[(hidden) WBl6TSRcS]]17
        
        https://github.com/aidam38/roamsr/blob/b99fae9243d1e00db4571b5eafb8791d85592d5f/src/ui/styles.js#[[(hidden) WBl6TSRcS]]69
    - [[(hidden) n212LBQqE]]
      - https://roamresearch.com/#[[(hidden) G97ohL3l8]]/app/developer-documentation/page/tIaOPdXCj
      - roamAlphaAPI resources
        
        https://roamresearch.com/#[[(hidden) G97ohL3l8]]/app/developer-documentation/page/K_unTEjJx
        
        (!) https://www.zsolt.blog/2021/01/Roam-Data-Structure-Query.html
        
        insanely good.
        
        {{[[TODO]]}} need to go through all material linked there
        
        further - "learn [[(hidden) 8iobLNJvy]]'s [[(hidden) xH-Ph8S9m]] today":
        
        http://www.learndatalogtoday.org/
        
        also "datomic datalog" in 7min
        
        https://www.youtube.com/watch?v=bAilFQdaiHk&feature=emb_title
        
        further
        
        https://roamresearch.com/#[[(hidden) G97ohL3l8]]/app/Zsolt-Blog/page/WUn5PuTDV
        
        further
        
        https://twitter.com/Roamfu/status/1363681695057121281
        
        further
        
        https://twitter.com/VladyslavSitalo/status/1362261990547197954
        
        https://twitter.com/VladyslavSitalo/status/1415296623693942791
        
        https://github.com/mathieudutour/gatsby-digital-garden/
        
        #observation people have been doing [[export-html-pages]]-like stuff for a while already!
        
        [[(hidden) zawAAHB3b]]
        
        https://github.com/mathieudutour/gatsby-digital-garden/issues/31#issuecomment-752807330
        
        https://github.com/roam-garden/roam-export/tree/757a777aac27777021f3ebab3c073893d7884951
        
        https://github.com/nikvdp/roam2agora
        
        {{[[TODO]]}} checkout [[(hidden) jZNl6HGob]]
        
        https://anagora.org/index
        
        [[(hidden) X3vwrXyD7]]
        
        https://github.com/dvargas92495/generate-roam-site-action
        
        #observation oh snap, they're doing everything __directly in [[roam]]__, and then using [[lambda functions]] ([[(hidden) g2-_urXV9]]/[[(hidden) _Ekrn0YvL]] or whatever)
        
        further https://github.com/dvargas92495/generate-roam-site/blob/main/src/index.ts
        
        further https://github.com/dvargas92495/roamjs-components
        
        [[(hidden) zJw7j5jxr]] holy shit, so much thoughts coming from this
        
        (hidden) b7GCT2svs:: "The Killers - Mr. Brightside (Lyrics)" ("it was just a kiss")
        
        https://youtu.be/UFKf08us2AI
        
        [[roam-traverse-graph]] [[export-html-pages]]
        
        thinking about how you can e.g. do in [[roam]]:
        
```javascript - further: - link - link```

vs ```javascript - further: link - further: link```

and how you could do that with linked references, if you were doing it:

```javascript - [[further]]: - link - link```
        
        vs ```javascript - [[further]]: link - [[further]]: link```
        
        {{[[TODO]]}} would [[roam attributes]] work better for this?
        
        i.e., you'd do the mentioning twice probably, like in the second part of either examples
        
        thought is that necessary? i think it's irrelevant actually
        
        initial thought - no, because the `(hidden) G97ohL3l8::` is in the end, and you'd have to manually write out the page's title instead of being able to search
        
        but wait, i never really use attributes, and that's not right! you can do `(hidden) G97ohL3l8::` and roam throws you in the beginning, and you can search just fine!
        
        okay so then that's no longer a problem
        
        next up - is this useful
        
        re:: ((EfE5J1OtG))
        
        why i thought it'd be useful is that you can only have one attribute per block. thus it'd force you to have more specific (verbose?) page titles instead of combining multiple ones:
        
        e.g. instead of [[roam-traverse-graph]] [[export-html-pages]], i could have a page titled "export-html-pages-plugin-of-roam-traverse-graph" or smthn, i don't yet know what'd be the optimal naming convention, but we could try to figure it out.
        
        i've even seen some people on [[roam]]'s [[(hidden) VZrbM9KJQ]] talk about some conventions
        
        but the main question here is -- is this overall a good thing?
        
        {{[[TODO]]}} #observation am i using attributes wrong?
        
        {{[[TODO]]}} more complex attribute handling in [[roam-traverse-graph]]
        
```javascript {{[[TODO]]}} ~~observation::~~ #observation am i using attributes wrong?```

or maybe like this? XD

observation:: {{[[TODO]]}} am i using attributes wrong?

{{[[TODO]]}} would need some extra integration help w/ the [[TODO]] toggle from [[roam]]

{{[[TODO]]}} figure out what [[roam attributes]] are all about / what their purpose is

[again](((vssQKBfFO))), the learning material of datalog could help

{{[[TODO]]}} thought also interesting what the [[roam]] people intended with them

cc:: [[(hidden) 1h9jVJvM-]]

{{[[TODO]]}} #[[(hidden) jOMmlCP4S]] if [[roam]] could provide a hooks/events api that you could listen from,

then the stuff that people are doing directly on roam, and we do in our runner locally / on github actions with [[roam-traverse-graph]] -- we could do all that in a remote environment as well, __but with much faster time intervals__ - they wouldn't even be intervals anymore, rather - reactions to events [1] happening live, as the user acts.

[1] in [[(hidden) xH-Ph8S9m]], it's [[(hidden) Vr3N0zG5Q]] isn't it?

(hidden) AV7J4zqkD:: ((YG-4tevRA))

this would likely require [[(hidden) BislYexyN]]s - detecting if changes have side effects that impact not only the edited block, but the whole page, or even the whole graph / parts of it

(hidden) AV7J4zqkD:: linking to a page - both pages need updating now

and if it's a meta page / has powers, then extra works to potentially any pages in the graph.

i.e. annoying stuff!

idk, maybe if we manage to keep the stuff fast, like it is now [1], then going thru the whole graph shouldn't be as bad?

e.g. we could have a queue of incoming events, and we'd only do 1 at a time, and if a new one comes in too fast, we'd wait for the currently one to complete, and in the meantime if more come in, we'd discard all the new ones except the newest, and then could go again.

[1] it takes ~5 seconds? to go from a `notes-private/graph.json` into a `notes-public/*.html`

and probably ~20 seconds when i introduce the stuff from the [[(hidden) nicjeov_l]] branch which is currently WIP.

((yxHMW9jlb))

ofc there's a lot of [[(hidden) BislYexyN]]s to be done, it's currently fairly naive. and, they seem more doable / easier than the side effect detection:

((RpqCi8rWX))

both assume 1. my size of the graph (1K pages, 8K words)

((FI6sCM5cI))

((xUKym_BXn))

((gf1mkreMz))

((spuKqLoxE))

((m1Fk_dVUP))

{{[[TODO]]}} datalog query builder w/ live preview, directly in [[roam]]?

maybe first gotta go thru the learning material above, lol

since this is getting so wide, i wonder how the generated html pages via [[export-html-pages]] will look like - i'd actually prefer if there was no wrapping and you could just scroll horizontally. will see soon once the export goes live

observation:: putting everything inside daily notes, vs referencing today's date in a specific page / block

if the page is public, but your daily notes aren't, then the stuff will also be public

but wait this is irrelevant because if using linked a linked reference which makes the stuff public, then it's the same effect, it juts ends up in the linked references of a page instead of directly inside it. [[duh]]!

{{[[TODO]]}} wait but i'm still confused myself now on how does the public vs public recursive logic work in [[roam-traverse-graph]] lol - is making a page "public" makes it public recursive as well?

e.g. even inline queries!!

:q [:find(count ?t):where[_ :node/title ?t]]

pages

:q [:find(count ?t):where[_ :block/string ?t]]

blocks
{{[[TODO]]}} #read roamAlphaAPI resources @ [[roam/js]]
- {{[[TODO]]}} (!) esp [[(hidden) 2q43bRV-X]]: (!) https://www.zsolt.blog/2021/01/Roam-Data-Structure-Query.html
  - {{[[TODO]]}} oh fuck, it might be a lot easier to do some things that we're already doing by parsing the raw text
  - {{[[TODO]]}} [[(hidden) d_BU9kVtB]] is looking more and more intriguing to try. [[(hidden) 8iobLNJvy]] as well

January 6th, 2022 (2)

WAIT i thought you'd have like a custom server and use [[roam-traverse-graph]] to parse the graph, and then have like a frontend dashboard SPA or whatever to confirm stuff. BUT hold up, we have [[roam/js]]. we can get rid of literally all of the #bs, and do everything directly in [[roam]] 🤯 for API calls to some endpoints, sure could use a server, or e.g. lambda functions. but perhaps roam directly is also fine, if we can securely keep secrets stored?
- [[(hidden) DY6wPnICE]]
  - [[roam]] as the personal "[[(hidden) pCdH3SJhT]]" / no-code / automations platform???
    - re:: "no-code" - lol, ofc you'd have to code up the [[(hidden) AqlNqCYG6]]s, but then you can share them and use them and everything's directly in roam. fuuuuuuuck this is [[(hidden) -MiVLWUzx]]
      - (hidden) D1lY0CG5e:: {{[[TODO]]}} ideally you'd be able to [[self-host]] [[roam]] because at this point you'd be [[running critical infrastructure]]
        
        cc:: [[roam "enterprise"]]
        
        thought beware -- remain user-focused, never [[(hidden) 6jcY_WnAD]], [[you gotta zuck'em]], stay [[(hidden) EJItNRkJG]], do not give power to the [[professional managerial class]]
      - {{[[TODO]]}} okay more [[(hidden) jOMmlCP4S]]s coming in from thinking about this:
        
        re:: `publicRecursive` tag @ [[export-html-pages]]
        
        maybe instead of `publicRecursive`, we need to make it a point that the purpose of this is to have everything in daily notes, and under that tag, blocks become public and end up in the page as a linked mention.
        
        so that it'd be made clear that this is the purpose of it, and not a general `publicRecursive` meta-tag. then, we'd be able to very easily detect if something is a "page collector" or whatever better name we come up with, and then e.g. the coloring stuff becomes way more precise
        
        {{[[TODO]]}} might even be useful for [[roam's multiplayer mode]] and the #[[(hidden) jOMmlCP4S]] of [["putting" things into multiple graphs]], or, rather, giving other, shared-graphs e.g. read access to some of your notes, if they're under that tag (while still being able to own them?)
        
        cc:: [[roam "enterprise"]]
        
        re:: ((wiW41Si-y))
        
        #[[(hidden) jOMmlCP4S]] / #[[(hidden) D1lY0CG5e]] for [[roam]] - would having a central place for settings, provided by the [[(hidden) AqlNqCYG6]]s / extensions, be useful?
        
        something similar to [[vscode]] i suppose
        
        thought about it because it'd likely save time / less http requests to do -- even if you have [[meta tags]], you don't need to 1. fetch your custom settings page, 2. fetch the linked references of the tags - you'd be ensured that 1. is always done & up-to-date (it's easier for roam if it itself tracks what's updated & when it is - just updates, otherwise caches)
        
        but, maybe inconvenience if you're using some other languages for the [[(hidden) AqlNqCYG6]]s (if even possible?), and in general feels less [[wild west]]-like / less [[(hidden) NWcsO1fe0]]. will see.
        
        {{[[TODO]]}} is [[re]] an [[anti-pattern]]? i.e. it becomes unclear if what you are "referring to" is from the content above, or some other page (if it's not a linked ref (of a page or a block) and just text) - you might start looking at the previous content but not find the thing that i meant to refer to, or even worse - could find something that is actually not the thing, and then get further confused. idk idk
{{[[TODO]]}} (hidden) 9jAzVgueo [[roam/js]] [[(hidden) AqlNqCYG6]] #[[(hidden) jOMmlCP4S]]
- (hidden) jnPkJ30pA #[[(hidden) S-ygYfi0j]] (hidden) AV7J4zqkD::
- (hidden) AKSrZmj9D
  - (hidden) -QTp4KCxN
    - (hidden) Xmud03FC5
    - (hidden) vpeoZVXot
  - (hidden) 9hAW3k0x2
- (hidden) qkSc0Tv1X

creating jira issues / sub-tasks from roam's TODOs (1)

related:: [[roam-traverse-graph]] [[roam/js]]

thread (1)

re:: enhance -- could create a [[roam/js]] extension for it

(hidden) qfvr4m1gA (1)

(hidden) VnMZ1csIl [[roam/js]] sibling::