feat: add admonition to all old course pages

honzajavorek · honzajavorek · commit 717e49c7f938 · 2025-10-15T16:02:41.000+02:00
diff --git a/sources/academy/platform/expert_scraping_with_apify/actors_webhooks.md b/sources/academy/platform/expert_scraping_with_apify/actors_webhooks.md
@@ -10,7 +10,7 @@ slug: /expert-scraping-with-apify/actors-webhooks
 **Learn more advanced details about Actors, how they work, and the default configurations they can take. Also, learn how to integrate your Actor with webhooks.**
 
 :::caution Updates coming
-This lesson is subject to change because it currently relies on code from our archived **Web scraping basics for JavaScript devs** course. For now you can still access the archived course, but we plan to close it in a few months. This lesson will be updated to remove the dependency.
+This lesson is subject to change because it currently relies on code from our archived **Web scraping basics for JavaScript devs** course. For now you can still access the archived course, but we plan to completely retire it in a few months. This lesson will be updated to remove the dependency.
 :::
 
 ---
diff --git a/sources/academy/platform/expert_scraping_with_apify/solutions/integrating_webhooks.md b/sources/academy/platform/expert_scraping_with_apify/solutions/integrating_webhooks.md
@@ -10,7 +10,7 @@ slug: /expert-scraping-with-apify/solutions/integrating-webhooks
 **Learn how to integrate webhooks into your Actors. Webhooks are a super powerful tool, and can be used to do almost anything!**
 
 :::caution Updates coming
-This lesson is subject to change because it currently relies on code from our archived **Web scraping basics for JavaScript devs** course. For now you can still access the archived course, but we plan to close it in a few months. This lesson will be updated to remove the dependency.
+This lesson is subject to change because it currently relies on code from our archived **Web scraping basics for JavaScript devs** course. For now you can still access the archived course, but we plan to completely retire it in a few months. This lesson will be updated to remove the dependency.
 :::
 
 ---
diff --git a/sources/academy/webscraping/anti_scraping/mitigation/using_proxies.md b/sources/academy/webscraping/anti_scraping/mitigation/using_proxies.md
@@ -10,7 +10,7 @@ slug: /anti-scraping/mitigation/using-proxies
 **Learn how to use and automagically rotate proxies in your scrapers by using Crawlee, and a bit about how to obtain pools of proxies.**
 
 :::caution Updates coming
-This lesson is subject to change because it currently relies on code from our archived **Web scraping basics for JavaScript devs** course. For now you can still access the archived course, but we plan to close it in a few months. This lesson will be updated to remove the dependency.
+This lesson is subject to change because it currently relies on code from our archived **Web scraping basics for JavaScript devs** course. For now you can still access the archived course, but we plan to completely retire it in a few months. This lesson will be updated to remove the dependency.
 :::
 
 ---
diff --git a/sources/academy/webscraping/scraping_basics/_legacy.mdx b/sources/academy/webscraping/scraping_basics/_legacy.mdx
@@ -0,0 +1,5 @@
+:::caution Archived course
+
+This is an archive of our old course. Check out our new [Web scraping basics for JavaScript devs](/academy/scraping-basics-javascript) course instead! We plan to completely retire this old course in a few months.
+
+:::
diff --git a/sources/academy/webscraping/scraping_basics_legacy/best_practices.md b/sources/academy/webscraping/scraping_basics_legacy/best_practices.md
@@ -6,10 +6,14 @@ slug: /scraping-basics-javascript/legacy/best-practices
 noindex: true
 ---
 
+import LegacyAdmonition from '../scraping_basics/_legacy.mdx';
+
 # Best practices when writing scrapers {#best-practices}
 
 **Understand the standards and best practices that we here at Apify abide by to write readable, scalable, and maintainable code.**
 
+<LegacyAdmonition />
+
 ---
 
 Every developer has their own style, which evolves as they grow and learn. While one dev might prefer a more  [functional](https://en.wikipedia.org/wiki/Functional_programming) style, another might find an [imperative](https://en.wikipedia.org/wiki/Imperative_programming) approach to be more intuitive. We at Apify understand this, and have written this best practices lesson with that in mind.
diff --git a/sources/academy/webscraping/scraping_basics_legacy/challenge/index.md b/sources/academy/webscraping/scraping_basics_legacy/challenge/index.md
@@ -6,10 +6,14 @@ slug: /scraping-basics-javascript/legacy/challenge
 noindex: true
 ---
 
+import LegacyAdmonition from '../../scraping_basics/_legacy.mdx';
+
 # Challenge
 
 **Test your knowledge acquired in the previous sections of this course by building an Amazon scraper using Crawlee's CheerioCrawler!**
 
+<LegacyAdmonition />
+
 ---
 
 Before moving onto the other courses in the academy, we recommend following along with this section, as it combines everything you've learned in the previous lessons into one cohesive project that helps you prove to yourself that you've thoroughly understood the material.
diff --git a/sources/academy/webscraping/scraping_basics_legacy/challenge/initializing_and_setting_up.md b/sources/academy/webscraping/scraping_basics_legacy/challenge/initializing_and_setting_up.md
@@ -6,10 +6,14 @@ slug: /scraping-basics-javascript/legacy/challenge/initializing-and-setting-up
 noindex: true
 ---
 
+import LegacyAdmonition from '../../scraping_basics/_legacy.mdx';
+
 # Initialization & setting up
 
 **When you extract links from a web page, you often end up with a lot of irrelevant URLs. Learn how to filter the links to only keep the ones you need.**
 
+<LegacyAdmonition />
+
 ---
 
 The Crawlee CLI speeds up the process of setting up a Crawlee project. Navigate to the directory you'd like your project's folder to live, then open up a terminal instance and run the following command:
diff --git a/sources/academy/webscraping/scraping_basics_legacy/challenge/modularity.md b/sources/academy/webscraping/scraping_basics_legacy/challenge/modularity.md
@@ -6,10 +6,14 @@ slug: /scraping-basics-javascript/legacy/challenge/modularity
 noindex: true
 ---
 
+import LegacyAdmonition from '../../scraping_basics/_legacy.mdx';
+
 # Modularity
 
 **Before you build your first web scraper with Crawlee, it is important to understand the concept of modularity in programming.**
 
+<LegacyAdmonition />
+
 ---
 
 Now that we've gotten our first request going, the first challenge is going to be selecting all of the resulting products on the page. Back in the browser, we'll use the DevTools hover tool to inspect a product.
diff --git a/sources/academy/webscraping/scraping_basics_legacy/challenge/scraping_amazon.md b/sources/academy/webscraping/scraping_basics_legacy/challenge/scraping_amazon.md
@@ -6,10 +6,14 @@ slug: /scraping-basics-javascript/legacy/challenge/scraping-amazon
 noindex: true
 ---
 
+import LegacyAdmonition from '../../scraping_basics/_legacy.mdx';
+
 # Scraping Amazon
 
 **Build your first web scraper with Crawlee. Let's extract product information from Amazon to give you an idea of what real-world scraping looks like.**
 
+<LegacyAdmonition />
+
 ---
 
 In our quick chat about modularity, we finished the code for the results page and added a request for each product to the crawler's **RequestQueue**. Here, we need to scrape the description, so it shouldn't be too hard:
diff --git a/sources/academy/webscraping/scraping_basics_legacy/crawling/exporting_data.md b/sources/academy/webscraping/scraping_basics_legacy/crawling/exporting_data.md
@@ -6,10 +6,14 @@ slug: /scraping-basics-javascript/legacy/crawling/exporting-data
 noindex: true
 ---
 
+import LegacyAdmonition from '../../scraping_basics/_legacy.mdx';
+
 # Exporting data {#exporting-data}
 
 **Learn how to export the data you scraped using Crawlee to CSV or JSON.**
 
+<LegacyAdmonition />
+
 ---
 
 In the previous lessons, you learned that:
diff --git a/sources/academy/webscraping/scraping_basics_legacy/crawling/filtering_links.md b/sources/academy/webscraping/scraping_basics_legacy/crawling/filtering_links.md
@@ -8,11 +8,14 @@ noindex: true
 
 import Tabs from '@theme/Tabs';
 import TabItem from '@theme/TabItem';
+import LegacyAdmonition from '../../scraping_basics/_legacy.mdx';
 
 # Filtering links {#filtering-links}
 
 **When you extract links from a web page, you often end up with a lot of irrelevant URLs. Learn how to filter the links to only keep the ones you need.**
 
+<LegacyAdmonition />
+
 ---
 
 Web pages are full of links, but frankly, most of them are useless to us when scraping. Filtering links can be approached in two ways: Targeting the links we're interested in by using unique CSS selectors, or extracting all links and then using pattern matching to find the sought after URLs. In real scraping scenarios, both of these two approaches are often combined for the most effective URL filtering.
diff --git a/sources/academy/webscraping/scraping_basics_legacy/crawling/finding_links.md b/sources/academy/webscraping/scraping_basics_legacy/crawling/finding_links.md
@@ -7,9 +7,12 @@ noindex: true
 ---
 
 import Example from '!!raw-loader!roa-loader!./finding_links.js';
+import LegacyAdmonition from '../../scraping_basics/_legacy.mdx';
 
 **Learn what a link looks like in HTML and how to find and extract their URLs when web scraping using both DevTools and Node.js.**
 
+<LegacyAdmonition />
+
 ---
 
 Many kinds of links exist on the internet, and we'll cover all the types in the advanced Academy courses. For now, let's think of links as [HTML anchor elements](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/a) with `<a>` tags. A typical link looks like this:
diff --git a/sources/academy/webscraping/scraping_basics_legacy/crawling/first_crawl.md b/sources/academy/webscraping/scraping_basics_legacy/crawling/first_crawl.md
@@ -6,10 +6,14 @@ slug: /scraping-basics-javascript/legacy/crawling/first-crawl
 noindex: true
 ---
 
+import LegacyAdmonition from '../../scraping_basics/_legacy.mdx';
+
 # Your first crawl {#your-first-crawl}
 
 **Learn how to crawl the web using Node.js, Cheerio and an HTTP client. Extract URLs from pages and use them to visit more websites.**
 
+<LegacyAdmonition />
+
 ---
 
 In the previous lessons, we learned what crawling is and how to extract URLs from a page's HTML. The only thing that remains is to write the code—let's get right to it!
diff --git a/sources/academy/webscraping/scraping_basics_legacy/crawling/headless_browser.md b/sources/academy/webscraping/scraping_basics_legacy/crawling/headless_browser.md
@@ -8,11 +8,14 @@ noindex: true
 
 import Tabs from '@theme/Tabs';
 import TabItem from '@theme/TabItem';
+import LegacyAdmonition from '../../scraping_basics/_legacy.mdx';
 
 # Headless browsers {#headless-browser}
 
 **Learn how to scrape the web with a headless browser using only a few lines of code. Chrome, Firefox, Safari, Edge - all are supported.**
 
+<LegacyAdmonition />
+
 ---
 
 A headless browser is a browser that runs without a user interface (UI). This means that it's normally controlled by automated scripts. Headless browsers are very popular in scraping because they can help you render JavaScript or programmatically behave like a human user to prevent blocking. The two most popular libraries for controlling headless browsers are [Puppeteer](https://pptr.dev/) and [Playwright](https://playwright.dev/). **Crawlee** supports both.
diff --git a/sources/academy/webscraping/scraping_basics_legacy/crawling/index.md b/sources/academy/webscraping/scraping_basics_legacy/crawling/index.md
@@ -7,8 +7,12 @@ slug: /scraping-basics-javascript/legacy/crawling
 noindex: true
 ---
 
+import LegacyAdmonition from '../../scraping_basics/_legacy.mdx';
+
 **Learn how to crawl the web with your scraper. How to extract links and URLs from web pages and how to manage the collected links to visit new pages.**
 
+<LegacyAdmonition />
+
 ---
 
 Welcome to the second section of our **Web scraping basics for JavaScript devs** course. In the [Basics of data extraction](../data_extraction/index.md) section, we learned how to extract data from a web page. Specifically, a template Shopify site called [Warehouse store](https://warehouse-theme-metal.myshopify.com/).
diff --git a/sources/academy/webscraping/scraping_basics_legacy/crawling/pro_scraping.md b/sources/academy/webscraping/scraping_basics_legacy/crawling/pro_scraping.md
@@ -6,10 +6,14 @@ slug: /scraping-basics-javascript/legacy/crawling/pro-scraping
 noindex: true
 ---
 
+import LegacyAdmonition from '../../scraping_basics/_legacy.mdx';
+
 # Professional scraping 👷 {#pro-scraping}
 
 **Learn how to build scrapers quicker and get better and more robust results by using Crawlee, an open-source library for scraping in Node.js.**
 
+<LegacyAdmonition />
+
 ---
 
 While it's definitely an interesting exercise to do all the programming manually, and we hope you enjoyed it, it's neither the most effective, nor the most efficient way of scraping websites. Because we scrape for a living at Apify, we've built a library that we use to scrape tens of millions of pages every day.
diff --git a/sources/academy/webscraping/scraping_basics_legacy/crawling/recap_extraction_basics.md b/sources/academy/webscraping/scraping_basics_legacy/crawling/recap_extraction_basics.md
@@ -6,10 +6,14 @@ slug: /scraping-basics-javascript/legacy/crawling/recap-extraction-basics
 noindex: true
 ---
 
+import LegacyAdmonition from '../../scraping_basics/_legacy.mdx';
+
 # Recap of data extraction basics {#quick-recap}
 
 **Review our e-commerce website scraper and refresh our memory about its code and the programming techniques we used to extract and save the data.**
 
+<LegacyAdmonition />
+
 ---
 
 We finished off the [first section](../data_extraction/index.md) of the _Web scraping basics for JavaScript devs_ course by creating a web scraper in Node.js. The scraper collected all the on-sale products from [Warehouse store](https://warehouse-theme-metal.myshopify.com/collections/sales). Let's see the code with some comments added.
diff --git a/sources/academy/webscraping/scraping_basics_legacy/crawling/relative_urls.md b/sources/academy/webscraping/scraping_basics_legacy/crawling/relative_urls.md
@@ -6,10 +6,14 @@ slug: /scraping-basics-javascript/legacy/crawling/relative-urls
 noindex: true
 ---
 
+import LegacyAdmonition from '../../scraping_basics/_legacy.mdx';
+
 # Relative URLs {#filtering-links}
 
 **Learn about absolute and relative URLs used on web pages and how to work with them when parsing HTML with Cheerio in your scraper.**
 
+<LegacyAdmonition />
+
 ---
 
 You might have noticed in the previous lesson that while printing URLs to the DevTools console, they would always show in full length, like this:
diff --git a/sources/academy/webscraping/scraping_basics_legacy/crawling/scraping_the_data.md b/sources/academy/webscraping/scraping_basics_legacy/crawling/scraping_the_data.md
@@ -6,10 +6,14 @@ slug: /scraping-basics-javascript/legacy/crawling/scraping-the-data
 noindex: true
 ---
 
+import LegacyAdmonition from '../../scraping_basics/_legacy.mdx';
+
 # Scraping data {#scraping-data}
 
 **Learn how to add data extraction logic to your crawler, which will allow you to extract data from all the websites you crawled.**
 
+<LegacyAdmonition />
+
 ---
 
 At the [very beginning of this course](../index.md), we learned that the term web scraping usually means a combined process of data extraction and crawling. And this is exactly what we'll do in this lesson. We will take the crawling code from the previous lesson, and we will combine it with data extraction code and turn everything into a web scraper.
diff --git a/sources/academy/webscraping/scraping_basics_legacy/data_extraction/browser_devtools.md b/sources/academy/webscraping/scraping_basics_legacy/data_extraction/browser_devtools.md
@@ -6,8 +6,12 @@ slug: /scraping-basics-javascript/legacy/data-extraction/browser-devtools
 noindex: true
 ---
 
+import LegacyAdmonition from '../../scraping_basics/_legacy.mdx';
+
 **Learn about browser DevTools, a valuable tool in the world of web scraping, and how you can use them to extract data from a website.**
 
+<LegacyAdmonition />
+
 ---
 
 Even though DevTools stands for developer tools, everyone can use them to inspect a website. Each major browser has its own DevTools. We will use Chrome DevTools as an example, but the advice is applicable to any browser, as the tools are extremely similar. To open Chrome DevTools, you can press **F12** or right-click anywhere in the page and choose **Inspect**. Now go to [Wikipedia](https://www.wikipedia.org/) and open your DevTools there.
diff --git a/sources/academy/webscraping/scraping_basics_legacy/data_extraction/computer_preparation.md b/sources/academy/webscraping/scraping_basics_legacy/data_extraction/computer_preparation.md
@@ -6,10 +6,14 @@ slug: /scraping-basics-javascript/legacy/data-extraction/computer-preparation
 noindex: true
 ---
 
+import LegacyAdmonition from '../../scraping_basics/_legacy.mdx';
+
 # Prepare your computer for programming {#prepare-computer}
 
 **Set up your computer to be able to code scrapers with Node.js and JavaScript. Download Node.js and npm and run a Hello World script.**
 
+<LegacyAdmonition />
+
 ---
 
 Before you can start writing scraper code, you need to have your computer set up for it. In this lesson, we will show you all the tools you need to install to successfully write your first scraper.
diff --git a/sources/academy/webscraping/scraping_basics_legacy/data_extraction/devtools_continued.md b/sources/academy/webscraping/scraping_basics_legacy/data_extraction/devtools_continued.md
@@ -6,8 +6,12 @@ slug: /scraping-basics-javascript/legacy/data-extraction/devtools-continued
 noindex: true
 ---
 
+import LegacyAdmonition from '../../scraping_basics/_legacy.mdx';
+
 **Continue learning how to extract data from a website using browser DevTools, CSS selectors, and JavaScript via the DevTools console.**
 
+<LegacyAdmonition />
+
 ---
 
 In the previous parts of the DevTools tutorial, we were able to extract information about a single product from the Sales collection of the [Warehouse store](https://warehouse-theme-metal.myshopify.com/collections/sales). If you missed the previous lessons, please go through them to understand the basic concepts. You don't need any of the code from there, though. We will start from scratch.
diff --git a/sources/academy/webscraping/scraping_basics_legacy/data_extraction/index.md b/sources/academy/webscraping/scraping_basics_legacy/data_extraction/index.md
@@ -7,10 +7,14 @@ slug: /scraping-basics-javascript/legacy/data-extraction
 noindex: true
 ---
 
+import LegacyAdmonition from '../../scraping_basics/_legacy.mdx';
+
 # Basics of data extraction {#basics}
 
 **Learn about HTML, CSS, and JavaScript, the basic building blocks of a website, and how to use them in web scraping and data extraction.**
 
+<LegacyAdmonition />
+
 ---
 
 Every web scraping project starts with some detective work. To a human, it's completely obvious where the data is on the web page, but a computer needs very precise instructions to find the data we want. We can leverage three elementary components of each website to give those instructions: HTML, CSS, and JavaScript
diff --git a/sources/academy/webscraping/scraping_basics_legacy/data_extraction/node_continued.md b/sources/academy/webscraping/scraping_basics_legacy/data_extraction/node_continued.md
@@ -6,8 +6,12 @@ slug: /scraping-basics-javascript/legacy/data-extraction/node-continued
 noindex: true
 ---
 
+import LegacyAdmonition from '../../scraping_basics/_legacy.mdx';
+
 **Continue learning how to create a web scraper with Node.js and Cheerio. Learn how to parse HTML and print the results of the data your scraper has collected.**
 
+<LegacyAdmonition />
+
 ---
 
 In the first part of the Node.js tutorial we downloaded the HTML of our [Warehouse store](https://warehouse-theme-metal.myshopify.com/collections/sales) and parsed it with Cheerio. Now, we will replicate the extraction logic from the [Extracting Data with DevTools](./using_devtools.md) lessons and finish our scraper.
diff --git a/sources/academy/webscraping/scraping_basics_legacy/data_extraction/node_js_scraper.md b/sources/academy/webscraping/scraping_basics_legacy/data_extraction/node_js_scraper.md
@@ -6,8 +6,12 @@ slug: /scraping-basics-javascript/legacy/data-extraction/node-js-scraper
 noindex: true
 ---
 
+import LegacyAdmonition from '../../scraping_basics/_legacy.mdx';
+
 **Learn how to use JavaScript and Node.js to create a web scraper, plus take advantage of the Cheerio and Got-scraping libraries to make your job easier.**
 
+<LegacyAdmonition />
+
 ---
 
 Finally, we have everything ready to start scraping! Yes, the setup was a bit daunting, but luckily, you only have to do it once. We have our project, we have our **main.js** file, so let's add some code to it.
diff --git a/sources/academy/webscraping/scraping_basics_legacy/data_extraction/project_setup.md b/sources/academy/webscraping/scraping_basics_legacy/data_extraction/project_setup.md
@@ -6,10 +6,14 @@ slug: /scraping-basics-javascript/legacy/data-extraction/project-setup
 noindex: true
 ---
 
+import LegacyAdmonition from '../../scraping_basics/_legacy.mdx';
+
 # Setting up your project {#setting-up}
 
 **Create a new project with npm and Node.js. Install necessary libraries, and test that everything works before starting the next lesson.**
 
+<LegacyAdmonition />
+
 ---
 
 When you open a website in a browser, the browser first downloads the page's HTML. To do the same thing with Node.js, we will install a program - an npm module - to help us with it. npm modules are installed using `npm`, which is another program, automatically installed with Node.js.
diff --git a/sources/academy/webscraping/scraping_basics_legacy/data_extraction/save_to_csv.md b/sources/academy/webscraping/scraping_basics_legacy/data_extraction/save_to_csv.md
@@ -6,10 +6,14 @@ slug: /scraping-basics-javascript/legacy/data-extraction/save-to-csv
 noindex: true
 ---
 
+import LegacyAdmonition from '../../scraping_basics/_legacy.mdx';
+
 # Saving results to CSV {#saving-to-csv}
 
 **Learn how to save the results of your scraper's collected data to a CSV file that can be opened in Excel, Google Sheets, or any other spreadsheets program.**
 
+<LegacyAdmonition />
+
 ---
 
 In the last lesson, we were able to extract data about all the on-sale products from [Warehouse Store](https://warehouse-theme-metal.myshopify.com/collections/sales). That's great. But we ended up with results printed to the terminal, which is not very useful for further processing. In this lesson, we'll learn how to save that data into a CSV file that you can then open in Excel or Google Sheets.
diff --git a/sources/academy/webscraping/scraping_basics_legacy/data_extraction/using_devtools.md b/sources/academy/webscraping/scraping_basics_legacy/data_extraction/using_devtools.md
@@ -6,8 +6,12 @@ slug: /scraping-basics-javascript/legacy/data-extraction/using-devtools
 noindex: true
 ---
 
+import LegacyAdmonition from '../../scraping_basics/_legacy.mdx';
+
 **Learn how to use browser DevTools, CSS selectors, and JavaScript via the DevTools console to extract data from a website.**
 
+<LegacyAdmonition />
+
 ---
 
 With the knowledge of the basics of DevTools we can finally try doing something more practical - extracting data from a website. Let's try collecting the on-sale products from the [Warehouse store](https://warehouse-theme-metal.myshopify.com/). We will use [CSS selectors](../../../glossary/concepts/css_selectors.md), JavaScript, and DevTools to achieve this task.
diff --git a/sources/academy/webscraping/scraping_basics_legacy/index.md b/sources/academy/webscraping/scraping_basics_legacy/index.md
@@ -8,10 +8,14 @@ slug: /scraping-basics-javascript/legacy
 noindex: true
 ---
 
+import LegacyAdmonition from '../scraping_basics/_legacy.mdx';
+
 # Web scraping basics for JavaScript devs {#welcome}
 
 **Learn how to develop web scrapers with this comprehensive and practical course. Go from beginner to expert, all in one place.**
 
+<LegacyAdmonition />
+
 ---
 
 Welcome to **Web scraping basics for JavaScript devs**, a comprehensive, practical and long form web scraping course that will take you from an absolute beginner to a successful web scraper developer. If you're looking for a quick start, we recommend trying [this tutorial](https://blog.apify.com/web-scraping-javascript-nodejs/) instead.
diff --git a/sources/academy/webscraping/scraping_basics_legacy/introduction.md b/sources/academy/webscraping/scraping_basics_legacy/introduction.md
diff --git a/src/components/LegacyJsCourseAdmonition.jsx b/src/components/LegacyJsCourseAdmonition.jsx

-Original file line number
+Diff line change
@@ @@ -0,0 +1,5 @@ @@
 +:::caution Archived course
++
 +This is an archive of our old course. Check out our new [Web scraping basics for JavaScript devs](/academy/scraping-basics-javascript) course instead! We plan to completely retire this old course in a few months.
++
 +:::