The Flavio Amiel Edition

[brunoamaral]

Take a seat, grab your favorite brew, there's a lot in this release for you.

1. SEO and Content

This release is a thank you to Flavio Amiel, he took some time to look at the website and offer some suggestions to improve the SEO and content.

This release implements some of those suggestions in content and in the url of articles listed. Previous URL was domain.com/articles/<article_id>, the new URL is domain.com/articles/<article_id>/<slug>, and the slug is taken from the noun_phrases found for each article title, to keep it a bit more relevant for search engines.

Content was also reviewed to include search keywords when possible.

Flavio was important not just because he took the time to look at our project but also because he took. a fresh look at a part of it that was ... overlooked.

If you're facing the same issues, you can reach him on twitter or schedule a call.

2. Setting up Gregory

We like to automate the boring stuff and making things easier for everyone.

If you're installing Gregory for the first time, run setup.py and it will take care of 80% of the work in setting up the database and the containers. This little sentence took quite some time but it's worth it to help people get their research up and running faster.

3. Filter feeds and API endpoints

Gregory has the concept of 'subject'. In this case, Multiple Sclerosis is the only subject configured. A Subject is a group of Sources and their respective articles. There are also categories that can be created. A category is a group of articles whose title matches at least one keyword in list for that category. Categories can include articles across subjects.

The one thing it didn't have was a way to filter by subject and category. So we added those options to the API and RSS Feeds in the format articles/category/ and articles/subject/ where and is the lowercase name with spaces replaced by dashes.

RSS Feeds

• Latest articles by subject, /feed/articles/subject/<subject>/, for example https://api.gregory-ms.com/feed/articles/subject/multiple-sclerosis/
• Latest articles by category, /feed/articles/category/<category>/, for example https://api.gregory-ms.com/feed/articles/category/mobility/

API endpoints

• /articles/subject/<subject>/, for example https://api.gregory-ms.com/articles/subject/multiple-sclerosis/
• /articles/category/<category>/, for example https://api.gregory-ms.com/articles/category/mobility/

4. Science paper, news, trials

What's in the news? Before this release Gregory could only understand science papers and clinical trials. We now have the option to include news articles without getting them mixed up with the other articles. You'll have to edit your current sources to make sure they have 'science paper' as the value of source for.

We're doing this to help follow the full process of scientific discovery, from publishing hypothesis, running clinical trials, and making it known to the people outside the scientific community.

5. Ignore SSL, if you must

In the past we had some issues reading RSS feeds whose web server didn't have the SSL certificate configured properly, and we were using a workaround that wasn't ideal because it turned off SSL verification for every request. This was fixed now, and each Source can be configured independently to bypass the certificate check if you really must.

What's Changed

• 197 add noun phrases to url keeping redirect from old format by @brunoamaral in 197 add noun phrases to url keeping redirect from old format #198
• truncate url to 250 maximum of characters by @brunoamaral in truncate url to 250 maximum of characters #199
• sync with main by @brunoamaral in sync with main #202
• 179 error on first install because there are no subscribers by @brunoamaral in 179 error on first install because there are no subscribers #204
• 192 articles should be of type paper and news by @brunoamaral in 192 articles should be of type paper and news #200
• send 1 email per admin, save status if at least one send = success by @brunoamaral in send 1 email per admin, save status if at least one send = success #203
• 191 create an rss feed and api endpoint per category and subject by @brunoamaral in 191 create an rss feed and api endpoint per category and subject #206
• remove hardcoded site domain by @brunoamaral in remove hardcoded site domain #207
• 175 error running setuppy for django by @brunoamaral in 175 error running setuppy for django #208
• Add documentation about env file by @brunoamaral in Add documentation about env file #209
• fix db host on setup.py by @brunoamaral in fix db host on setup.py #210
• Add documentation about env file and build script by @brunoamaral in Add documentation about env file and build script #211
• set env variables after user configures them by @brunoamaral in set env variables after user configures them #214
• remove relation to sitesettings and django.contrib.sites by @brunoamaral in remove relation to sitesettings and django.contrib.sites #215
• run django commands from setup script by @brunoamaral in run django commands from setup script  #216
• 132 implement a better approach to ssl problems in feedreader indexer by @brunoamaral in 132 implement a better approach to ssl problems in feedreader indexer #217

Full Changelog: v10.7...v11

---

This discussion was created from the release The Flavio Amiel Edition.