A WebExtension to copy selected web page into Org-mode formatted text!
I develop and release all my open-source software projects for free, and are ALL licensed under
Attention: Donate only if you feel happy; it is totally voluntary, I would never force you to do this. I always try as possible as I can to make good project because I need, and wish my work could also be helpful to others. If you donate, I will be glad and grateful, but I cannot provide any gurantee or warranty for this project even if you do this. Thanks for your contribution!WTFPL
,GPL
,MIT
, orMPL
. however, my “free time” is not free actually. If my works are usable to you or make you happy, please consider to donate to reduce my business hours to make more free and open-source projects for you and this world.
- Firefox for Desktop >= 92
- Node
- web-ext
- GNU Make
* Outline
,1. ordered list
,- unordered list
,- [ ] GitHub style todo list
| Table | Can | Be | Copied! |
- Paragraph
<p>
, Horizontal splitter--------
- Quoteblock
#+begin_quote
, Codeblock (: one line code...
or#+begin_src
+ auto guess language ID. e.g.js
,c
,shell
) *bold*
,/italic/
,_underline_
,+strike+
,=verbatim=
,~code~
,_{sub}
,^{sup}
[[link url][link title]]
,[[a.href][img.src]]
(Notice: multiple<img>
elements + other elements wrapped in<a>
element is not supported by org-mode syntax. I have serveral plans as workaround for this but haven’t decided which one is better, hence not implemented this yet..)[[imgSrc]]
(Notice: I haven’t decide how to deal with HTMLtitle
andalt
attribute)
- It’s IMPOSSIBLE to use this add-on under some special pages or domains like https://addons.mozilla.org/ . This is the restriction of Firefox browser itself.
- Nested mark (e.g.
*=bold and=* /=italic code=/
) may has some issues for org-mode renderer. This is a common usage in HTML, but may mess up the org-mode renderer. This is the limitation of org-mode’s syntax & renderer, I cannot do anything for it. - Some block elements in
<a>
(e.g.<img>
) may cannot be handled properly. This is the limitation of org-mode’s syntax. I’ve not decided which workaround should I use currently.For example,
<a> inner text 1 <img src="..."> another text 2 <img src="..."> another text 3 </a>
- One of the workarounds I can think up so far is to split each Node and make each of them an independent links, but looks disgusting… Like
[[url][inner text 1]] [[url][imgsrc]] [[url][another text 2]] [[url][imgsrc]] [[url][another text 3]]
.... - Or use
#+HTML: <a href="url">
and#+HTML:</a>
to wrap the children contents and elements. However, this will make the<a>
to a block element and create unneeded inevitable new lines.
- One of the workarounds I can think up so far is to split each Node and make each of them an independent links, but looks disgusting… Like
<pre>
may lost newlines in some page (e.g. https://kuanyui.github.io/2017/08/16/macros-for-qproperty/). Should be fixed now but I cannot sure.- Notification may freeze the whole Firefox when using on Linux (Test on Firefox 92, Ubuntu & Manjaro), but such issue seems not occurs on Firefox for Windows. So I make this feature an optional setting, you can enable it manually.
This software is created by a paranoidTM free-software & open-source enthusiast, would never collect your any data. Feel free to review the whold code base if doubt.
Permission (in manifest.json ) | Description | Will show a permission warning when install? |
---|---|---|
activeTab | Insert HTML parser to current active tab. | No |
menus | Add items to context menu. | No |
clipboardWrite | Copy org-mode text into clipboard. | Yes |
notifications | Show notification via OS when copy (optional). | Yes |
storage | Store preferences in sync (Mozilla Sync account) | No |
npm i
make dev
web-ext run --verbose --firefox-profile ~/.mozilla/firefox/PROFILE_DIR_NAME
If webpack watch exit immediately without any error, please try https://github.com/guard/listen/wiki/Increasing-the-amount-of-inotify-watchers
web-ext run --verbose --firefox-profile ~/.mozilla/firefox/XXXXXXX.NAME
make xpi-server
make zip-repo
This project referred, forked, or used some parts of the codes from the other projects:
Project URL | Usage | Licenses of Used Parts |
---|---|---|
0x6b/copy-selection-as-markdown | Main project structure; copy and selection handling | MIT |
mixmark-io/turndown | Forked as HTML to Org-Mode converter | MIT |
piroor/treestyletab | The CSS for options_ui (settings page) | MPL 2.0; MIT |
- Customizable keyboard shortcuts.
- Image to data URL?
MPL-2.0.
See LICENSE for more information.