update the README to reflect the early stages

This commit is contained in:
Andreas Zweili 2020-10-13 23:20:27 +02:00
parent 33eddf37a3
commit 026de5fa71
1 changed files with 7 additions and 11 deletions

View File

@ -1,5 +1,7 @@
# url2markdown # url2markdown
!!!url2markdown is still under development and not suited for production yet!!!
url2markdown lets you download an URL and save it as a Markdown file. url2markdown lets you download an URL and save it as a Markdown file.
Additionally you can provide a list of tags which will get added to the top of Additionally you can provide a list of tags which will get added to the top of
the file. The main idea behind the script is to download articles and feed them the file. The main idea behind the script is to download articles and feed them
@ -16,22 +18,16 @@ url2markdown https://docs.python.org/3/howto/argparse.html --tags=Python,CLI
## Installation ## Installation
Install url2markdown by running: Install url2markdown by cloning the repository and inside it run:
```bash ```bash
pip3 install url2markdown make init
``` ```
or by running:
```bash
make
```
Which will produce an executable called `url2markdown` under `dist`.
## Usage ## Usage
Currently you have to navigate into the repository and run `python3 url2markdown` in order to run the programm.
```bash ```bash
usage: url2markdown [-h] (--file FILE | --url URL) [--topics TOPICS] usage: url2markdown [-h] (--file FILE | --url URL) [--topics TOPICS]
@ -48,7 +44,7 @@ can optionally provide topics to which the Markdown version of the article
should get linked to. should get linked to.
```bash ```bash
url2markdown --url https://docs.python.org/3/library/argparse.html --topics Python,command line python3 url2markdown --url https://docs.python.org/3/library/argparse.html --topics Python,command line
``` ```
If you provide a file add the topics right behind the If you provide a file add the topics right behind the