Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/huangrunhua/the-new-yorker-database
The New Yorker article database, stored with JSON format.
https://github.com/huangrunhua/the-new-yorker-database
apple-news article database ios ipados news
Last synced: 2 months ago
JSON representation
The New Yorker article database, stored with JSON format.
- Host: GitHub
- URL: https://github.com/huangrunhua/the-new-yorker-database
- Owner: HuangRunHua
- Created: 2022-09-27T04:13:18.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2023-12-29T14:26:24.000Z (about 1 year ago)
- Last Synced: 2023-12-29T15:31:49.595Z (about 1 year ago)
- Topics: apple-news, article, database, ios, ipados, news
- Language: Swift
- Homepage:
- Size: 29.8 MB
- Stars: 2
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# the-new-yorker-database
The New Yorker article database which is stored with JSON format is uses for the data base of my next **News+** app.
### Article Structure
An `Article` is structed with the following `JSON` format.
```json
{
"coverImageURL": "THE URL OF ARTICLE COVER IMAGE",
"coverImageWidth": 442.5,
"coverImageHeight": 688,
"coverImageDescription": "THE DESCRIPTION OF COVER IMAGE",
"title": "THE TITLE OF THE ARTICLE",
"subtitle": "THE SUBTITLE OF THE ARTICLE",
"hashTag": "THE TAG OF THIS ARTICLE",
"authorName":"THE AUTHOR'S NAME",
"publishDate": "THE DATE OF ARTICLE IS PUBLISHED"
"contents": [
{
"role": "body",
"text": "THE TEXT OF BODY SECTION"
},
{
"role": "image",
"imageURL": "THE URL OF CONTENT'S IMAGE THAT WILL BE INSERTED INSIDE AN ARTICLE",
"imageWidth": 295.88,
"imageHeight": 251.67,
"imageDescription": "THE DESCRIPTION OF IMAGE",
},
{
"role": "quote",
"text": "THE TEXT OF QUOTE PART INSIDE THE ARTICLE"
}
...
]
}
```
### Magazine Structure
A `Magazine` contains multiple `Article` structures and some other data and is stored in `JOSN` format.
```json
{
"id": "00000000-0000-0000-0000-000000000000",
"date": "Oct 3rh 2022",
"coverStory": "Mark Ulriksen’s “All Rise!”",
"coverImageWidth": 555,
"coverImageHeight": 688,
"coverImageURL": "https://media.newyorker.com/photos/632de17e882c6ff52b2d3b1f/master/w_380,c_limit/2022_10_03.jpg",
"articles": [
{
"articleURL": "https://github.com/HuangRunHua/the-new-yorker-database/raw/main/database/2022_10_03/the-shock-and-aftershocks-of-the-waste-land/article.json"
},
{
"articleURL": "https://github.com/HuangRunHua/the-new-yorker-database/raw/main/database/2022_10_03/how-to-recover-from-a-happy-childhood.json"
}
]
}
```
### Database Structure
The `Database` contains all the magazines that are stored in the server. The structure of `Database` is also `JSON` style format.
```json
[
{
"id": 0,
"magazineURL": "https://github.com/HuangRunHua/the-new-yorker-database/raw/main/database/2022_09_26/2022_09_26.json"
},
{
"id": 1,
"magazineURL": "https://github.com/HuangRunHua/the-new-yorker-database/raw/main/database/2022_10_03/2022_10_03.json"
}
]
```
### Example
The attached `example` folder contains the code level example of how to fetch the `JSON` data and form a news app according to the data format mentioned above. The core UI of this app is shown in the following photo:
### Last but not least
Since `The New Yorker` is a weekly magazine fills with abundant articles, the update of the weekly new issue may not catch up in time. Noted I also add the `Time magazine` to database and I still name the repository `the-new-yorker-database`, I just lazy and don't want to change the name.