Skip to content

Latest commit

 

History

History

opentecture-bookmarks

README.md

You are now in a GitHub source code view - click this link to view Read Me file as a web page


Opentecture Bookmarks Read Me

Full screen: Add-a-line Bookmarks

  • Basic bookmark manager and editor with tagging, descriptions and comments

Full screen: Add-a-line Bookmarks Capture

  • Bookmarks file creator: open, parse and save your browser's bookmarks to a JSON lines file

Full screen: Add-a-line Bookmarks Scrape

  • Add descriptions and favicons to bookmarks by scraping the source URL

bookmarks.json

  • The current Opentecture bookmarks JSON Lines file

Coming next: a script to display bookmarks in an attractive, memorable and usable manner.

Concept

The scripts here are a side project of the gbXML to JSON Lines project. They are a work-in-progress continuation of manipulating JSON Lines files in useful ways.

The scripts here are also an attempt to explore ways of managing browser bookmarks in a collaborative, simple and open-source manner.

  • Access very large numbers of bookmarks
  • View contents of many sites in a speedy fashion
  • View bookmarks listed by host name with ease and speed
  • Speed up identification with descriptions added on-the-fly
  • Curate the output using comments

See also a more fully developed concept at Annotated Bibliography Read Me

Problem to be solved

There are many excellent lists on the web. For example:

You may spend many enjoyable hours exploring the links in these lists. There are, however, a number of issues with this process.

  • Given hundreds of uninformative/un-curated links, how can you prioritize what you want to see?
  • Having seen a number of good pages, at some later date how can you come back to the list and return to the pages you like and not return to the pages you did not feel were useful to your current search?
  • Given hundreds of links on general interest, how can you use search tools to help you find sites of immediate interest?
  • How do you prevent parsing very long read me files with naked links from becoming a tedious process?
  • How can you view lots of sites yet minimize the number of clicks to do so
  • What is a good workflow for adding links to bookmarks in your browser then getting these links into markdown?

Objectives

  • Build a list [of resources] good enough for inclusion here: https://github.com/sindresorhus/awesome
  • Establish effective ways of managing curated lists of bookmarks
  • Take a bunch of links from browser bookmark manager and get them into a JSON file quickly and easily
  • View and manage links with a tree-view menu system

Make viewing many bookmarks pleasurable, memorable and speedy

  • With tree in left menu / contents to right
    • Bookmarks may be viewed by browsing a tree of categories
    • Bookmarks may be searched for by typing in search text
    • Bookmarks may be located using tags

When multiple results are available bookmark targets are displayed with images and text in a Pinterest/Etsy/Cool Tools store-like gallery sort of manner.

Clicking on one of the boxes, will bring up the full page for the site including user comments, date of latest site update, typical images from the site and more

Make curating many bookmarks easy-peasy

  • With a click of a button grab bookmarks you have gathered using your browser and its bookmark manager
  • Add images from the site and/or embed in the site in an iframe - if the target site offers that capability
  • Tools are there to help you grab descriptions, text and images from the target site
  • Add categories and tags is a matter of selecting items from drop-down lists
  • Comments may be added and edited using Markdown or HTML

Make development of the viewing and curating tools simple enough for programming beginners to have fun with

  • Data stored as JSON lines files
  • Hosting on no-charge static servers such as GitHub or Glitch
  • Nothing to download. Nothing to install. All FOSS.
  • Reference scripts written in plain-vanilla JavaScript
    • Very few dependencies. Files of just a few hundred lines
    • Should be easy to rebuild for use with tools of your choice

Collaborate and manage the process with a number of peeps

  • The effort may have multiple owners with full access and others with limited access
  • The decision-making process is online and documented

Links of interest

Links we have enjoyed while preparing this code

"Knowledge managers"

We make customer messaging apps for sales, marketing, and support, connected on one platform. Our mission is to make business personal again.

Convert bookmark dates to UTC

Compare document generators

Scripts to generate documents from code

Add UUID

Wish List / To Do

  • 2019-09-13 ~ Theo ~ Every bookmark is a separate file << not necessary any more. see dev notes
    • Add "path" types instead
  • 2019-09-13 ~ Theo ~ Comments may have tags such as "forCynthia" or "actionNeeded"
  • 2019-09-13 ~ Theo ~ There is a "folders" type that keeps the tree info for a bookmark << yes, this is it
  • 2019-09-13 ~ Theo ~ All bookmark files may be package into a zip file
  • 2019-06-10 ~ Theo ~ Add readme files for all the modules

Issues

Change Log

2019-06-22 ~ Theo

  • what is the Stack Overflow for good answers?
  • What is the Yelp for deep knowledge
  • What is the Apple or GitHub for curated content?
  • Where are the Amazon comments for STEM topics?

More

  • There are an infinite amount of possible URLs, with perhaps many trillions already in use. How can we find, retain, and return to the good ones?
  • How can we catalog and share the URLs that point to good science?

For any topic that you may be interested in, you may gather dozens, maybe even hundreds, of bookmarks linking to blog posts, Wikipedia articles, journal articles and other sources. What are good waus of dealing with all these URLs?

For software updates see also #sandbox/opentecture-bookmarks/add-a-line-bookmarks/README.md

2019-06-10 ~ Theo

  • First commit Add-a-line Bookmarks v 0.5.0

To do items dealt with

  • 2019-05-13 ~ delete www for page titles
  • 2019-05-13 ~ Start adding comments
  • 2019-05-13 ~ Enable adding new tags
  • 2019-05-13 ~ Close button on popup help
  • 2019-05-13 ~ Links to sites in left menu
  • 2019-03-17 ~ Enable creating new bookmarks from scratch
  • 2019-03-17 ~ Make it easier to add new images
  • 2019-03-17 ~ Be able to edit bookmarks with same tools from any of the viewers

2019-05-12 ~ Theo

  • First commit r 0.4.0

Very happy with the way things are progressing - even though not ready to show or discuss much for now.

2019-03-31 ~ Theo

  • Re-build read me based on Add-a-line Bookmarks2

2019-03-17 ~ Theo

CORS workaround working again. Yay!

Update readme and links

2019-03-16 ~ Theo

  • Update readme

Yikes! My primary web-scraping tool - https://cors-anywhere.herokuapp.com/ is having issues

2019-03-02 ~ Theo

It's looking like a nice way of keeping things is to use the originating web site of the content. Assign very basic categories

❦