Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update readme #14

Merged
merged 1 commit into from
Dec 29, 2023
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
65 changes: 43 additions & 22 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,10 @@
# rss-medium-blog-viewer

This README outlines the details of collaborating on this Ember application.
A short introduction of this app could easily go here.
The RSS Medium Blog Viewer is an Ember application designed to transform your Medium blog into a personalized, self-hosted blog. This enables bloggers to display their Medium content in a unique and customizable format on their personal website.

## Demo

Here is a [demo](https://blog.zfir.dev/) of the application

## Prerequisites

Expand All @@ -18,34 +21,52 @@ You will need the following things properly installed on your computer.
* `cd rss-medium-blog-viewer`
* `npm install`

## Running / Development
## Setup Environment Variables

* Create a .env file
* Add the following properties based on your details in the file
* PAGE_TITLE
* Use to set title of the page
* ICON_URL
* Use to set an icon on the top left of the page
* Can be a local file that is uploaded in the public folder
* Can be an online link
* If not set, it will use the title of the page as default
* MEDIUM_URL
* Original link of your medium page
* Example 1: https://medium.com/@zfir
* Example 2: https://zfir.medium.com/
* MEDIUM_FEED_URL
* Link to the feed of your medium page
* Note: It is not same as the MEDIUM_URL
* Example: https://medium.com/feed/@zfir
* RSS_2_JSON_API_KEY
* API Key from the service rss2json
* Sign up for a key on this [link](https://rss2json.com/)

Here is an example of how your .env file should look:
```
PAGE_TITLE="Zafir's Blogs"
ICON_URL=https://miro.medium.com/v2/resize:fill:64:64/1*NxSbBQe2m7Hab7G4KljJhA.jpeg
MEDIUM_URL=https://zfir.medium.com/
MEDIUM_FEED_URL=https://medium.com/feed/@zfir
RSS_2_JSON_API_KEY=<YOUR_API_KEY>
```

## Local Development

* `npm run start`
* Visit your app at [http://localhost:4200](http://localhost:4200).
* Visit your tests at [http://localhost:4200/tests](http://localhost:4200/tests).

### Code Generators

Make use of the many generators for code, try `ember help generate` for more details

### Running Tests

* `npm run test`
* `npm run test:ember -- --server`

### Linting

* `npm run lint`
* `npm run lint:fix`
## Deployment

### Building
### Local

* `npm exec ember build` (development)
* `npm run build` (production)
* `npm exec ember build`

### Deploying
### Production

Specify what it takes to deploy your app.
* `npm run build`

## Further Reading / Useful Links

Expand Down
Loading