Skip to content

Commit 0147218

Browse files
authored
feat: tidy up the tutorials navigation (#1873)
- I removed the PHP section containing a sole article. The article is about using the Apify API from PHP, so I've put it inside the Apify API section. I keep the slug untouched to avoid unnecessary redirects for now. I redirect the root of the former PHP section directly to this article, but not permanently, in case we would like to have the section back again in the future. - I changed the titles and H1s of the section and index pages so that they're consistent. In titles, which are displayed on Google search results, I wanted to have the "tutorials" word included, but in H1s, which are displayed in the context of the navigation and docs UI, I opted for a more brief heading. - The articles in the Apify API section seem to be assorted, so I removed `sidebar_position:` from their meta. - "Apify scrapers" felt very vague, so I changed it to "Tutorials on ready-made Apify scrapers", which is what the section is actually about. I thought I could have a single section for Apify stuff in the tutorials, where I'd move the https://docs.apify.com/academy/running-a-web-server page, but the "Tutorials on ready-made Apify scrapers" section is too self-contained and the intro expects certain contents and ordering. I don't know exactly yet what I'll do with it, but this PR feels like a good first step, groundworks for further changes.
1 parent 97b3d99 commit 0147218

File tree

9 files changed

+13
-30
lines changed

9 files changed

+13
-30
lines changed

nginx.conf

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -310,6 +310,7 @@ server {
310310

311311
# Academy restructuring
312312
rewrite ^academy/advanced-web-scraping/scraping-paginated-sites$ /academy/advanced-web-scraping/crawling/crawling-with-search permanent;
313+
rewrite ^academy/php$ /academy/php/use-apify-from-php redirect; # not permanent in case we want to reuse /php in the future
313314

314315
# Removed pages
315316
# GPT plugins were discontinued April 9th, 2024 - https://help.openai.com/en/articles/8988022-winding-down-the-chatgpt-plugins-beta

sources/academy/tutorials/api/index.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,12 @@
11
---
2-
title: API tutorials
2+
title: Tutorials on Apify API
33
description: A collection of various tutorials explaining how to interact with the Apify platform programmatically using its API.
4-
sidebar_position: 20
4+
sidebar_position: 6
55
category: tutorials
66
slug: /api
77
---
88

9-
# API Tutorials 💻📚
9+
# Using Apify API
1010

1111
**A collection of various tutorials explaining how to interact with the Apify platform programmatically using its API.**
1212

sources/academy/tutorials/api/retry_failed_requests.md

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,6 @@
11
---
22
title: How to retry failed requests
33
description: Learn how to resurrect your run but retrying only failed requests
4-
sidebar_position: 6
54
slug: /api/retry-failed-requests
65
---
76

sources/academy/tutorials/api/run_actor_and_retrieve_data_via_api.md

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,6 @@
11
---
22
title: Run Actor and retrieve data via API
33
description: Learn how to run an Actor/task via the Apify API, wait for the job to finish, and retrieve its output data. Your key to integrating Actors with your projects.
4-
sidebar_position: 6
54
slug: /api/run-actor-and-retrieve-data-via-api
65
---
76

sources/academy/tutorials/php/using_apify_from_php.md renamed to sources/academy/tutorials/api/using_apify_from_php.md

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,6 @@
11
---
22
title: Use Apify via API from PHP
33
description: Learn how to access Apify's REST API endpoints from your PHP projects using the guzzle package. Follow a tutorial to run an Actor and download its data.
4-
sidebar_position: 1
54
slug: /php/use-apify-from-php
65
---
76

sources/academy/tutorials/apify_scrapers/index.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,11 @@
11
---
2-
title: Apify scrapers
2+
title: Tutorials on ready-made Apify scrapers
33
description: Discover Apify's ready-made web scraping and automation tools. Compare Web Scraper, Cheerio Scraper and Puppeteer Scraper to decide which is right for you.
4-
sidebar_position: 13.2
4+
sidebar_position: 5
55
slug: /apify-scrapers
66
---
77

8-
# Scraping with Apify
8+
# Using ready-made Apify scrapers
99

1010
**Discover Apify's ready-made web scraping and automation tools. Compare Web Scraper, Cheerio Scraper and Puppeteer Scraper to decide which is right for you.**
1111

sources/academy/tutorials/node_js/index.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,12 @@
11
---
2-
title: Node.js tutorials
2+
title: Tutorials on scraping with Node.js
33
description: A collection of various Node.js tutorials on scraping sitemaps, optimizing your scrapers, using popular Node.js web scraping libraries, and more.
4-
sidebar_position: 14
4+
sidebar_position: 2
55
category: tutorials
66
slug: /node-js
77
---
88

9-
# Node.js Tutorials 💻📚
9+
# Scraping with Node.js
1010

1111
**A collection of various Node.js tutorials on scraping sitemaps, optimizing your scrapers, using popular Node.js web scraping libraries, and more.**
1212

sources/academy/tutorials/php/index.md

Lines changed: 0 additions & 15 deletions
This file was deleted.

sources/academy/tutorials/python/index.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,12 @@
11
---
2-
title: Python tutorials
2+
title: Tutorials on scraping with Python
33
description: A collection of various Python tutorials to aid you in your journey to becoming a master web scraping and automation developer.
4-
sidebar_position: 15
4+
sidebar_position: 3
55
category: tutorials
66
slug: /python
77
---
88

9-
# Python Tutorials 🐍📚
9+
# Scraping with Python
1010

1111
**A collection of various Python tutorials to aid you in your journey to becoming a master web scraping and automation developer.**
1212

0 commit comments

Comments
 (0)