feat(2403): wire up learn page #2446
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,7 +1,9 @@ | ||
| import os | ||
| import random | ||
| import re | ||
|
|
||
| import requests | ||
| from django.db.models import Count | ||
| from django.utils import timezone | ||
|
|
||
| from textwrap import dedent | ||
|
|
@@ -86,8 +88,10 @@ | |
| save_rendered_content, | ||
| ) | ||
|
|
||
|
|
||
| from libraries.models import Category, Library, LibraryVersion, Tier | ||
| from news.models import Entry | ||
| from news.services import get_latest_post_cards | ||
| from libraries.utils import ( | ||
| get_commit_data_by_release_for_library, | ||
| commit_data_to_stats_bars, | ||
|
|
@@ -506,155 +510,175 @@ def get_v3_context_data(self, **kwargs): | |
| ctx["learn_card_data"] = [ | ||
| { | ||
| "title": "I want to learn:", | ||
| "text": ( | ||
| "How to install Boost, use its libraries, build projects, " | ||
| "and get help when you need it." | ||
| ), | ||
| "links": [ | ||
| { | ||
| "label": "Explore common use cases", | ||
| "url": "/doc/user-guide/common-introduction.html", | ||
| }, | ||
| { | ||
| "label": "Build with CMake", | ||
| "url": "/doc/user-guide/building-with-cmake.html", | ||
| }, | ||
| { | ||
| "label": "Visit the FAQ", | ||
| "url": "/doc/user-guide/faq.html", | ||
| }, | ||
| ], | ||
| "url": "/doc/user-guide/getting-started.html", | ||
| "label": "Get started with Boost", | ||
| "image_src": large_static("/img/v3/learn-page/learn-cheetah.png"), | ||
| "mobile_image_src": large_static( | ||
| "/img/v3/learn-page/cheetah-mobile.png" | ||
| ), | ||
| }, | ||
| { | ||
| "title": "I want to contribute:", | ||
| "text": ( | ||
| "How to contribute to Boost, propose new libraries, " | ||
| "and engage in formal reviews." | ||
| ), | ||
| "links": [ | ||
| { | ||
| "label": "Contribute to an existing library", | ||
| "url": "/doc/contributor-guide/contributors-faq.html", | ||
| }, | ||
| { | ||
| "label": "Learn about formal reviews", | ||
| "url": "/doc/formal-reviews/submissions.html", | ||
| }, | ||
| { | ||
| "label": "Visit the Contributors FAQ", | ||
| "url": "/doc/contributor-guide/contributors-faq.html", | ||
| }, | ||
| ], | ||
| "url": "/doc/contributor-guide/requirements/library-requirements.html", | ||
| "label": "Propose a new library", | ||
| "image_src": large_static("/img/v3/learn-page/learn-octopus.png"), | ||
| "mobile_image_src": large_static( | ||
| "/img/v3/learn-page/octopus-mobile.png" | ||
| ), | ||
| }, | ||
| ] | ||
|
|
||
| ctx["library_cards"] = self._build_category_cards() | ||
|
|
||
| # Copy mirrors the Figma frame at node 1849:49695. The design currently | ||
| # has two cards titled "Modern approach to C++" — flagged to design. | ||
|
Comment on lines
+569
to
+570
Collaborator
There was a problem hiding this comment. Can we follow up with design and remove this comment from code? 🙏
Collaborator
Author
There was a problem hiding this comment. I'll update once we get news from @rbbeeston 👍 |
||
| ctx["why_boost_cards"] = [ | ||
| { | ||
| "title": "Modern approach to C++", | ||
| "description": "Skip months of development with production-ready solutions.", | ||
| }, | ||
| { | ||
| "title": "Write safer code", | ||
| "description": "Peer-reviewed by C++ standards committee members.", | ||
| }, | ||
| { | ||
| "title": "Make real impact", | ||
| "description": "Your code could power millions of apps & shape the future of C++.", | ||
| }, | ||
| { | ||
| "title": "Modern approach to C++", | ||
| "description": "We embrace contemporary C++ practices, leveraging the latest language features.", | ||
| }, | ||
| { | ||
| "title": "Template-heavy by design", | ||
| "description": "Maximum flexibility with compile-time guarantees.", | ||
| }, | ||
| { | ||
| "title": "Independent but consistent", | ||
| "description": "Each library is built by a small, dedicated team with shared standards.", | ||
| }, | ||
| ] | ||
|
|
||
| ctx["calendar_card"] = { | ||
| "title": "Boost is released three times a year", | ||
| "text": ( | ||
| "Each release has updates to existing libraries, and any new " | ||
| "libraries that have passed the rigorous acceptance process." | ||
| ), | ||
| "primary_button_url": reverse("calendar"), | ||
| "primary_button_label": "View release calendar", | ||
| "image": large_static("/img/v3/demo-page/calendar.png"), | ||
| } | ||
| ctx["info_card"] = { | ||
| "title": "How we got here", | ||
| "text": ( | ||
| "Since 1998, Boost has been where C++ innovation happens. What " | ||
| "started with three developers has grown into the foundation of " | ||
| "modern C++ development." | ||
| ), | ||
| "primary_button_url": "/doc/user-guide/boost-history.html", | ||
| "primary_button_label": "Explore our history", | ||
| } | ||
| ctx["post_cards_data"] = { | ||
| "heading": "Posts from the Boost community", | ||
| "view_all_url": reverse("news"), | ||
| "view_all_label": "View all posts", | ||
| "posts": get_latest_post_cards(limit=4), | ||
| } | ||
| ctx["boost_community_data"] = { | ||
| "heading": "The Boost community", | ||
| "primary_cta_label": "Explore the community", | ||
| "primary_cta_url": reverse("community"), | ||
| "items": [ | ||
| { | ||
| "title": "Stay up to date", | ||
| "description": "Watch the Boost GitHub org for the latest releases and activity.", | ||
| "cta_url": "https://github.com/boostorg/boost", | ||
| "cta_label": "Watch now", | ||
| }, | ||
| { | ||
| "title": "Get help", | ||
| "description": "Chat with thousands of C++ developers on the CPPLang Slack.", | ||
| "cta_url": "https://cppalliance.org/slack/", | ||
| "cta_label": "Join now", | ||
| }, | ||
| { | ||
| "title": "Fix an issue", | ||
| "description": "Browse open issues and contribute fixes on GitHub.", | ||
| "cta_url": "https://github.com/boostorg/boost/issues", | ||
| "cta_label": "Get involved", | ||
| }, | ||
| ], | ||
| } | ||
| return ctx | ||
|
|
||
| @staticmethod | ||
| def _build_category_cards(): | ||
| """Return library categories shuffled per request, with live counts.""" | ||
| categories = list( | ||
| Category.objects.annotate(library_count=Count("libraries", distinct=True)) | ||
| .filter(library_count__gt=0) | ||
| .exclude(name__isnull=True) | ||
| .exclude(name="") | ||
| .only("name", "slug", "short_description") | ||
|
ycanales marked this conversation as resolved.
|
||
| ) | ||
| random.shuffle(categories) | ||
| cards = [] | ||
| for category in categories: | ||
| cards.append( | ||
| { | ||
| "title": category.name, | ||
| "description": category.short_description, | ||
| "badge_count": category.library_count, | ||
| "cta_label": "Start here", | ||
| "cta_href": reverse( | ||
| "libraries-list", | ||
| kwargs={ | ||
| "version_slug": LATEST_RELEASE_URL_PATH_STR, | ||
| "library_view_str": "categorized", | ||
| "category_slug": category.slug, | ||
|
Collaborator
Collaborator
Author
There was a problem hiding this comment. If @julhoang's PR merges first I could adjust it here, or in a follow-up ticket, whatever's best 👍 |
||
| }, | ||
| ), | ||
| } | ||
| ) | ||
| return cards | ||
|
|
||
|
|
||
| class ContentNotFoundException(Exception): | ||
| pass | ||
|
|
||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,22 @@ | ||
| # Generated by Django 6.0.2 on 2026-05-14 16:27 | ||
|
|
||
| from django.db import migrations, models | ||
|
|
||
|
|
||
| class Migration(migrations.Migration): | ||
|
|
||
| dependencies = [ | ||
| ("libraries", "0039_flag_known_bot_commit_authors"), | ||
| ] | ||
|
|
||
| operations = [ | ||
| migrations.AddField( | ||
| model_name="category", | ||
| name="short_description", | ||
| field=models.TextField( | ||
| blank=True, | ||
| default="", | ||
| help_text="Short marketing copy shown on the Learn page category carousel.", | ||
| ), | ||
| ), | ||
| ] |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Uh oh!
There was an error while loading. Please reload this page.