Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add About Page #196

Open
wants to merge 5 commits into
base: main
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
26 changes: 16 additions & 10 deletions docusaurus.config.js
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ const lightCodeTheme = themes.github;
const darkCodeTheme = themes.dracula;

/** @type {import('@docusaurus/types').Config} */
const config = {
export default {
title: "conda.org",
tagline: "Package and environment management for any language and platform",
url: "https://conda.org",
Expand Down Expand Up @@ -39,29 +39,29 @@ const config = {
format: "detect",
},

stylesheets: [
"https://cdn.jsdelivr.net/npm/[email protected]/dist/css/bootstrap.min.css",
],

presets: [
[
"classic",
/** @type {import('@docusaurus/preset-classic').Options} */
({
{
docs: {
path: "learn",
routeBasePath: "learn",
sidebarPath: "./learn/_sidebar.js",
// Please change this to your repo.
// Remove this to remove the "edit this page" links.
editUrl: "https://github.com/conda-incubator/conda-dot-org/tree/main",
},
blog: {
showReadingTime: true,
// Please change this to your repo.
// Remove this to remove the "edit this page" links.
editUrl: "https://github.com/conda-incubator/conda-dot-org/tree/main",
},
theme: {
customCss: require.resolve("./src/css/custom.css"),
},
}),
},
],
],

Expand All @@ -77,7 +77,7 @@ const config = {
items: [
{
// type=doc entries need a docId that corresponds to
// a filename under docs/, without extension
// a filename under docs (see preset config for docs), without extension
type: "doc",
docId: "faq",
position: "left",
Expand All @@ -89,6 +89,12 @@ const config = {
label: "Community",
},
{ to: "/blog", label: "Blog", position: "left" },
{
type: "doc",
docId: "about",
position: "left",
label: "About",
},
{
href: "https://github.com/conda",
label: "GitHub",
Expand Down Expand Up @@ -184,6 +190,7 @@ const config = {
debug: false, // Set debug to true if you want to inspect the modal
},
}),

plugins: [
[
"@docusaurus/plugin-ideal-image",
Expand All @@ -202,6 +209,7 @@ const config = {
path: "community",
routeBasePath: "community",
sidebarPath: "./community/_sidebar.js",
editUrl: "https://github.com/conda-incubator/conda-dot-org/tree/main",
async sidebarItemsGenerator({ defaultSidebarItemsGenerator, ...args }) {
// This function takes the contents of sidebarPath, and will return
// only the entries that had to be autogenerated (i.e. meeting minutes)
Expand All @@ -213,5 +221,3 @@ const config = {
],
],
};

module.exports = config;
3 changes: 2 additions & 1 deletion learn/_sidebar.json
Original file line number Diff line number Diff line change
@@ -1,3 +1,4 @@
[
"faq"
"faq",
"about"
]
34 changes: 34 additions & 0 deletions learn/about.mdx
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

If you want this file as a separate page in the top menu (and not under Learn), you need to put it under src/pages so it's standalone. Otherwise we get this weird "two menu entries are active" situation (see Learn and About in the top bar):

image

Original file line number Diff line number Diff line change
@@ -0,0 +1,34 @@
import Card from "react-bootstrap/Card";
import CardGroup from "react-bootstrap/CardGroup";
import Link from "@docusaurus/Link";

# About

Who are we and where can you find us?

## Bots

<CardGroup style={{ width: "30rem" }}>
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Are adding bootstrap for this only? Not sure if the extra dependency + CSS is worth it when this is essentially a table. We'd need to assess impact on load times and data transfers.

<Card>
<Link to="https://github.com/conda-bot">
<Card.Img variant="top" src="/img/authors/conda-bot.svg" />
<Card.Body>
<Card.Title>@conda-bot</Card.Title>
<Card.Text>I'm a bot, helping the conda community.</Card.Text>
</Card.Body>
</Link>
</Card>
<Card>
<Link to="https://github.com/conda-conduct">
<Card.Img variant="top" src="/img/authors/conda-conduct.svg" />
<Card.Body>
<Card.Title>@conda-conduct</Card.Title>
<Card.Text>I'm a sheriff, protecting the conda community.</Card.Text>
</Card.Body>
</Link>
</Card>
</CardGroup>

## [Sub-teams](https://github.com/conda/governance#sub-teams)

## [Steering Council](https://github.com/conda/governance#steering-council)
Loading
Loading