UrlMark

Write yourself a home page with bookmarks well-organized, browser-agnostic and easy-to-share.

Installation

Recommended Way

git clone https://github.com/NoviceLive/urlmark.git

Add --recursive to obtain example Markdown files, as well as templates.

Add --deth 1 to prevent cloning unnecessary histories. However, this may of no help since UrlMark uses its gh-pages as a submodule which will result in full clone.
cd urlmark
pip install -r requirements.txt
make install (Optional)

Alternatives

pip install urlmark

No example Markdown files and no templates, which are required if you don’t want to write your own.

Get Started

Write the left and right side links in Markdown lists.

It looks like this and in gh-pages of this repository, there are examples of left.md and right.md.

- [FOSS](#)
    - [Repositories](#)
        - [GitHub](https://github.com/)
        - [Bitbucket](https://bitbucket.org/)
        - [GitLab](https://about.gitlab.com/)
        - [SourceForge](http://sourceforge.net/)
        - [CodePlex](https://www.codeplex.com/)
        - [GitCafe](https://gitcafe.com/)

Write a template.

You can use the included template in gh-pages branch, but it may not look eyeful. Here is the demo: Online Bookmarks.

It shall has three placeholders: {left}, {right}, {time}.

And all other uses of brackets must be escaped as in Python str.format.

Run ./urlmark.py with necessary options.

If you name your left and right side as left.md and right.md, your template as template, you can just run ./urlmark.py with no options on their residing directory.

./urlmark.py --help
Usage: urlmark.py [OPTIONS]

  Write you self a home page with well-organized bookmarks.

Options:
  -l, --left FILENAME      Use this as the left side.  [default: left.md]
  -r, --right FILENAME     Use this as the right side.  [default: right.md]
  -t, --template FILENAME  Use this template.  [default: template.html]
  -o, --output FILENAME    Write to this file.  [default: index.html]
  --help                   Show this message and exit.

Brainstorm & TODO

How about integrating command line interface like cym13/bookmark?
Mobile view (i.e. responsive or not)?
Does it look good?
Write some fantastic themes (a.k.a templates)?

Disclaimer

Bookmarks in example left.md and right.md are highly personal, and may have no other implications except personal convenience for the time being.

Release files for UrlMark 0.4.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for UrlMark 0.4.0
File	Size	Uploaded
UrlMark-0.4.0.tar.gz	31.4 kB	Feb 28, 2016	Details

Release files / UrlMark-0.4.0.tar.gz

Download URL	UrlMark-0.4.0.tar.gz
Size	31.4 kB
Tags	Source
SHA-256 checksum How to use checksums	`f410d396a32f39c82c8b1b2b8fe332c8527455a0ef47484b859454437878b62c`
BLAKE2b-256 checksum How to use checksums	`37cf9e8fa1fcce6d0c23a25e13498c64c298e149f19354607ab30f05669c5132`
Upload date	Feb 28, 2016
Uploaded using Trusted Publishing? What is trusted publishing?	No