Search
Full
Incoming links

static-roam/TODOs

11 Jul 2021 02:01 - 08 Jan 2022 10:04

    • Logseq related

      • see logseq/static-roam-issues
      • DONE Logseq uses different syntax for italics etc.
      • DONE do something with page aliases
        • DONE rewrite old klunky Roam aliases {{alias...}} etc
      • DONE times are completely not working,
        • maybe use .md file times? Seems easy
        • for blocks, could mine git log, but that sounds hard
          • actually blame could do it, couldn't it??? Hm.
          • also autogit is not working any more (fixed I think)
      • DONE git publishing
        • a few more complications than I thought
        • DONE need to put in some linebreaks for git to have any chance
          • OR, is it possible to configure git...hm...looks like not
        • DONE need to eliminate the timestamp on footer, it will make each file gratuitously changed
        • DONE makes more sense now to separate out the map json...especially since map isn't even displayed by default!
          • TODO should have the same info on a special about page, just for grins
      • TODO seem to be a lot of broken block refs from import (well one at least), should check for those.
        • fixed so error would be caught at least
    • Major features

      • Publish via git
        • TODO 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
      • SPA navigation
        • Currently uses naive Web 1.0 nav, which is slow and blanks the screen, not the feel I want.
        • See logseq/publish for better
        • specifically, the screen blanks for a noticable time as you switch pages. Ruins the mood and attention.
      • Rename
        • TODO needs a new name, it's diverged enough.
      • green links (pre-nav popups)
        • Someone asked for these, but I don't feel like my own stuff would really benefit that much.
        • Logseq has these so maybe that will push me over the edge
      • 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 (solution: use git)
        • Parsing is the slow step. One idea is to cache the parse on disk and only reparse and regenerate as necessary.
      • Some kind of feed for subscribers
        • eg, post link to changes every week to a Twitter account
      • 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

      • DONE make side graph open/close sticky, not sure how?
      • TODO side graph highlighting should show path from hover node to current page; and in an actually legible way. This would make it actually useful, which it isn't really now.
      • TODO block properties for various things
        • Immediate need: adding a css class to an image so it can have a border; currently images with white background bleed into the page and looks weird.
      • Needs new front page strategy, but god knows what
      • DONE 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.
        • Not quite sure what I meant by that
      • DataViz thing
        • sort of spontaneously grew
        • which I can't link to because it's implemented wrong
        • TODO graphics should match those in force-layout view, more or less.
          • would be cool to include edges but that might be out of scope
        • DONE 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)
      • TODO links from Recent Changes and sidebar should be to particular block
        • TODO (which requires rendering anchors)
      • TODO 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.
      • TODO 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

      • DONE Looks like search index includes non-displayed text!!! (example: "Elder" matches hidden text at GBG).
      • TODO 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?
      • TODO isn't smart about quoting html like
        is probably going to get rendered as a rule, and it shouldn't.
      • TODO 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")
      • TODO 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; haxve 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
        • ???
      • Page/tag structure: now that the Rationality essays are no longer a main thing, they should be framed, given some kind of boilerplate and a different look. Not sure.