Search
MapFull
Incoming links

static-roam/TODOs

11 Jul 2021 02:01 - 30 Aug 2021 12:24

    • Major features

      • green links (pre-nav popups)
        • Someone asked for these, but I don't feel like my own stuff would really benefit that much.
      • Hosted publishing. See static-roam/saas
      • random idea: the computing-a-subset-graph-via-closure functionality is useful for Roam in general; eg if a graph gets too big and you want to split it.
        • could be another static-roam/saas service
      • Blogger import
      • Scaling
        • Map doesn't scale, and publishing is getting slow. Not sure what to do.
        • Parsing is the slow step. One idea is to cache the parse on disk and only reparse and regenerate as necessary.
        • Use git for incremental deploy, will speed up as well as make a record of changes.
          • Colophon will change on every page; maybe that can be hacked
      • needs a new name, it's diverged enough.
      • Some kind of feed for subscribers
        • eg, post link to changes every week to a Twitter account
      • Full-page navigation looks like ass, use something more SPA-like
        • specifically, the screen blanks for a noticable time as you switch pages. Ruins the mood and attention.
      • Make graph more dynamic
        • I probably will cut back radius to 1, but that makes it almost useless, all the links are already on the page.
        • Note: nav from graph should also be SPA-like, see above
        • Better yet, allow graph nodes to expand in place on user click.
        • Better yet, get rid of the hairball and have something better (but that's kind of a research project)
    • Minor features

      • Needs new front page strategy, but god knows what
      • Minor redesign in progress
        • Moved boxes to LH so sidenotes don't collide
        • Need to tweak widths, sidenotes now collide with main text!
        • Stick DataViz somewhere
        • Make Map box link to full Map rather than RH menu
      • Bare tags (like book in a line) should not render themselves in text. They should maybe appear as tags since that's what they are, or even trigger css variations or big icons to create some visual differentiation of the sea of pages.
      • DataViz thing
        • sort of spontaneously grew
        • which I can't link to because it's implemented wrong
        • graphics should match those in force-layout view, more or less.
          • would be cool to include edges but that might be out of scope
        • adjust labels and legend
        • Version for me with all blocks, color-coded by public or not
      • Have an author tag that adds a byline; then can import other texts and have clear visual indication of authorship (see Minsky True Names Afterword for an application).
        • That's for quoting stuff from other sources, but it might also be a feature to support multiple Roam authors. Not an issue for my solo site.
      • More curatorial features (replace dead links with archive.org links, check for bad Markdown, etc)
        • Really need a Roam write API (or equivalent) for this and Blogger import and other things.
        • It's easy to accidently paste in links (esp. images) that are temp urls from CDNs. These should be detected and copied if possible. Dead link detection would also be useful
        • Have an option to download all images on Roam servers and include as part of static site (if not, probably will break if you stop paying the Roam bills)
      • links from Recent Changes and sidebar should be to particular block
        • (which requires rendering anchors)
      • Roam tables not being rendered right at all
        • Might not be worth supporting this and other Roam features; but there should at least be a warning when you do a build and hit a feature like this.
      • for empty pages (or maybe specifed with flag) the Incoming Links section should be in main body of page – bare column looks weird
      • On-page about box with contact / feedback info
        • See meaningness for good example
        • Goes well with
          • Some kind of feed for subscribers
            • eg, post link to changes every week to a Twitter account
      • frequency table
        • Done the guts, but a UI won't make sense without a search for words to link to, or staticly creating fake pages
        • can do it now that we have search, but it turns out to not be that interesting, given the existing wiki-ish page titles.
    • Bugs

      • If there are two pages whose names differ only in case (eg author and Author) you end up with broken links, at least if you are going through a case-folding filesystem like MacOS. Should detect and warn user.
      • Performance sucks
        • All the time is spent in instaparse
        • Trying to slim down the grammar actually made things worse for some reason
        • I'm wondering if dispensing with instaparse and using some hacky regex parser would be an improvement...prob not?
        • Noticing that it is even worse if you rerun -main ,,, like it crawls. Not sure why, suspect memoization? Nothing else should change between runs, but its hard to see that producing such a dramatic slowdown.
          • Might have fixed these, should test to make sure
        • OK, I now have a deploy script. takes 4.5 minutes (for around 300 pages)
          • Use git for deploy, would be a lot faster
          • Some kind of incremental page rebuild. It's parsing thats's slow, so cache locally and use Roam timestamps to invalidatate.
      • Mobile: Menubar not quite working, can't see New and other rhs options?
      • isn't smart about quoting html like
        is probably going to get rendered as a rule, and it shouldn't.
      • Apparent search bug? Query for "Minsk" matches somethings that "Minsky" doesn't, for no obvious reason (suspect handling of apostrophe, issue might be pages with "Minsky's")
      • Vivarium Project page has colors inverted in the graph
        • Ah this is because Vega assigns colors in order.
      • Need to check the parser for ambiguities
        • Worked some on this, needs work.
    • Assorted ideas

      • Idea: bare urls are ugly; have some automation that goes and fixes them.
        • Good first step towards blogger, will have to solve computational update problem
      • Some nodes are hyperconnected (like Further reading) and might be better if they were excluded from the graph.
      • Idea (esp if I import blog posts) have system of icons for different page types; show them.
        • Old blog post
        • Notes
        • Essay
        • Review
        • Person (Author)
        • Subject matter
          • Hacks / technology
          • Politics
          • Agency
        • ???