Asocial-bookmark NPM

asocial-bookmark

Personal bookmark system on GitHub repository.

Features

Manage your bookmark on GitHub
Update bookmark data via GitHub API
Postem integration

Install

Install with npm:

npm install asocial-bookmark

Requirements:

ECMAScript 2017+

Usage

GitHub mode.

import { AsocialBookmark } from "asocial-bookmark";

(async () => {
    if (!process.env.GH_TOKEN) {
        throw new Error("Set env GH_TOKEN=xxx");
    }
    const asocialBookmark = new AsocialBookmark({
        github: {
            owner: "azu",
            repo: "mybookmarks",
            ref: "heads/master",
            token: process.env.GH_TOKEN
        }
    });
    const date = new Date();
    const isoDate = new Date(date.getTime() - (date.getTimezoneOffset() * 60000)).toISOString();
    await asocialBookmark.updateBookmark({
        title: "example",
        url: "https://example.com",
        content: "description for example",
        date: isoDate,
        tags: ["example"]
    });

    const bookmark = await asocialBookmark.getBookmark({
        url: "https://example.com",
        date: new Date().toUTCString()
    });
    console.log("bookmark", bookmark);
    const tags = await asocialBookmark.getTags();
    console.log("tags", tags);
})();

CLI

RUN following CLI in your bookmark repository.

Migrate はてなブックマーク to asocial-bookmark

$ cd your-bookmarks-repository/
$ migrate-hatenabookmark-to-asocial-bookmark --hatena <user-name>

Create index.json that includes all bookmarks.

$ cd your-bookmarks-repository/
$ asocial-bookmark-create-index

How to create your bookmark repository

WIP: It is complex workflow.

Create your repository.
- Example: https://github.com/{your}/mybookmarks
Convert existing bookmark like "はてなブックマーク" to asocial-bookmark
- Run $ migrate-hatenabookmark-to-asocial-bookmark --hatena <user-name>
- For more details, see src/cli/migrate-hatenabookmark-to-asocial-bookmark.ts
Setup CI/CD - Netlify is useful in this case
- Run $ asocial-bookmark-create-index that create index.json before each deploy
- Enable CORS for https://<your-bookmark>/index.json
- All bookmarks: https://<your-bookmark>/index.json
- All tags: https://<your-bookmark>/tags.json
- Block bookmarks by month: https://<your-bookmark>/:year/:month/index.json

.netlify.toml in your bookmark repository:

# example netlify.toml
[build]
  command = "asocial-bookmark-create-index"
  functions = "functions"
  publish = "."
  #  status = 200
[[headers]]
  for = "/index.json"
  [headers.values]
    Access-Control-Allow-Origin = "*"

Post bookmark to your repository via postem
- See https://github.com/azu/postem/blob/master/src/services/asocial-bookmark/README.md

src/service.js in postem

const path = require("path");
module.exports = [
    {
        enabled: true,
        name: "twitter",
        indexPath: path.join(__dirname, "services/twitter/index.js")
    },
    {
        enabled: true,
        name: "AsocialBookmark",
        indexPath: path.join(__dirname, "services/asocial-bookmark/index.js")
    }
];

Search Bookmark on はてなブックマーク検索PWA
- Input https://<your-bookmark>/index.json to "hatena user name"
- Very Very Hack But Work!
- Do incremental search!