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 community content resource page #5661

Merged
merged 24 commits into from
Dec 20, 2024
Merged
Show file tree
Hide file tree
Changes from 6 commits
Commits
Show all changes
24 commits
Select commit Hold shift + click to select a range
ab9afa0
add community content page
nomadscientist Dec 19, 2024
8a46c90
add the rest of the resources, off the top of my head
nomadscientist Dec 19, 2024
79525ee
add blog post
nomadscientist Dec 19, 2024
dcd928c
link tutorial
nomadscientist Dec 19, 2024
1f5bdc3
added FAQ on finding pages
nomadscientist Dec 19, 2024
ef59515
Merge branch 'main' into comm_page
nomadscientist Dec 19, 2024
3ae3f4c
Update news/_posts/2024-12-19-community_page.md
nomadscientist Dec 19, 2024
0e1b9d4
Update topics/community/tutorials/community_content/tutorial.md
nomadscientist Dec 19, 2024
4035c92
fix subtopic label
nomadscientist Dec 19, 2024
1944cd5
Merge branch 'comm_page' of https://github.com/nomadscientist/trainin…
nomadscientist Dec 19, 2024
247dbf0
Merge branch 'main' into comm_page
nomadscientist Dec 19, 2024
811d0ee
Update topics/community/tutorials/community_content/tutorial.md
shiltemann Dec 19, 2024
dbd403e
change Page to Home
nomadscientist Dec 19, 2024
9332617
Merge branch 'comm_page' of https://github.com/nomadscientist/trainin…
nomadscientist Dec 19, 2024
f7436a5
Add FAQ on calendar addition
nomadscientist Dec 19, 2024
8f156a4
add calendar FAQ link
nomadscientist Dec 19, 2024
d02c183
Merge branch 'main' into comm_page
nomadscientist Dec 19, 2024
be2446a
Update topics/community/faqs/topic_pages.md
nomadscientist Dec 19, 2024
d6c9f84
fix indent errors?
shiltemann Dec 19, 2024
b555406
Update topics/community/faqs/topic_pages.md
shiltemann Dec 19, 2024
a349413
Update topics/community/faqs/topic_pages.md
shiltemann Dec 19, 2024
89765b5
tweak faqs, iframes
shiltemann Dec 20, 2024
f9b6b09
typo
shiltemann Dec 20, 2024
05101ab
add id to section
shiltemann Dec 20, 2024
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
41 changes: 41 additions & 0 deletions news/_posts/2024-12-19-community_page.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,41 @@
---
title: "GTN's Gift for 2024"
contributions:
authorship:
- nomadscientist
- hexylena
tags: [gtn, single-cell, new feature, new tutorial]
nomadscientist marked this conversation as resolved.
Show resolved Hide resolved
layout: news
cover: "news/images/spoc_images/community_page.png"
coveralt: "four graphs showing increases over time: training materials including slides and tutorials; contributors; workflows; and other"
---

# Community Pages

# 🎉 Ring in 2025 with the GTN’s Amazing New Feature! 🎉

We’re absolutely *thrilled* to introduce the fabulous **Community Page**—a glorious new addition that has us cheering! 🎊

Here’s why we’re so excited: this page **automatically** tracks and celebrates all the incredible resource contributions from our community over time. 🚀 Whether it’s new workflows, fresh training materials, or awesome contributors, everything is summed up for you, hassle-free!

Gone are the days of frantically piecing together achievements to impress institutes or grant bodies. No more scratching your head at year’s end wondering, *“Wait... what *did* we accomplish?”* GTN gets it. 💡 We know trainers are superheroes juggling this alongside their full-time research or infrastructure roles.

Now, with sleek live charts, we can *see* how our community shines 🌟—in real time! It’s a joyful reflection of all the hard work, dedication, and collaboration that make this community so special.

So here’s a huge **THANK YOU** to the GTN team for this spectacular gift! 🥳 You’ve truly embodied the spirit of user-centered design—not just for the scientists using Galaxy, but for those of us building it, too. 💖

Here’s to an exciting 2024 full of growth, achievements, and community magic! 🎆

#GratefulForGTN

You can find this and other useful features in a [new tutorial collecting community resources]( {% link topics/community/tutorials/community_content/tutorial.md %} ).

Finally, you can see an example from the Single-cell topic below:

<iframe
src="https://training.galaxyproject.org/training-material/topics/single-cell/community.html"
width="100%"
height="800"
style="border: none;"
title="Single-Cell Topic Community Page">
</iframe>
Binary file added news/images/spoc_images/community_page.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
22 changes: 22 additions & 0 deletions topics/community/faqs/topic_pages.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,22 @@
---
title: How do I find the Community & Maintainer pages?
box_type: tip
layout: faq
contributors: [nomadscientist, hexylena]
---

You can find your **Community Page** and **Maintainer Page** by scrolling down on your training **Topic** page.

> <hands-on-title>Go to your topic page resources</hands-on-title>
>
> 1. Go to any training topic of interest. This will have the form
> ```
> https://training.galaxyproject.org/training-material/topics/<your topic here>
shiltemann marked this conversation as resolved.
Show resolved Hide resolved
> ```
> 2. Add a #community to the end of the url.
> ```
> https://training.galaxyproject.org/training-material/topics/<your topic here>#community
shiltemann marked this conversation as resolved.
Show resolved Hide resolved
> ```
> 3. Select a page to explore!
>
{: .hands_on}
8 changes: 8 additions & 0 deletions topics/community/metadata.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -9,5 +9,13 @@ summary: |
#docker_image: "quay.io/galaxy/community"
learning_path_cta: dev_tools_training

subtopics:
- id: sigs
title: "Special Interest Groups & Communities"
description: "These tutorials will get you started with the basics of what a special interest group is and how to build one."
- id: subdomain
title: "Subdomains & Galaxy Labs"
description: "This tutorial will guide you on how to build subdomains / Galaxy Labs"

editorial_board:
- nomadscientist
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,7 @@ title: Creation of an interactive Galaxy tools table for your community
level: Introductory
redirect_from:
- /topics/dev/tutorials/community-tool-table/tutorial
subtopic: sig
nomadscientist marked this conversation as resolved.
Show resolved Hide resolved

questions:
- Is it possible to have an overview of all Galaxy tools for a specific scientific domain?
Expand Down
3 changes: 3 additions & 0 deletions topics/community/tutorials/community_content/faqs/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
---
layout: faq-page
---
166 changes: 166 additions & 0 deletions topics/community/tutorials/community_content/tutorial.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,166 @@
---
layout: tutorial_hands_on
priority: 1
subtopic: sig
title: "Creating community content"
questions:
- "What content does my Topic automatically get from the GTN?"
- "How can I make sure this data is collected well?"
objectives:
- "Signpost community leads and users to useful resources"
- "Explain why metadata is key for such community resources"
- "Provide a reference, rather than a tutorial"
time_estimation: "30"
nomadscientist marked this conversation as resolved.
Show resolved Hide resolved
key_points:
- "The GTN has worked hard to provide automated metrics and resources to highlight and acknowledge the efforts of communities and community leads"
- "This only works if we contribute with effective tagging."
nomadscientist marked this conversation as resolved.
Show resolved Hide resolved
requirements:
contributions:
authorship:
- nomadscientist
requirements:
shiltemann marked this conversation as resolved.
Show resolved Hide resolved
-
type: "internal"
topic_name: community
tutorials:
- sig_define
---

Galaxy *[Special Interest Group](https://galaxyproject.org/community/sig)* (**SIG**)s work hard to build and maintain training resources. The GTN has worked hard to acknowledge this and offer nice impact pages to communities.

Here is a list of resources that you can use!

> <comment-title></comment-title>
> - We want this material to grow (similar to the 'Creating content in markdown' tutorial) so please do add further resources that can help communities!
{: .comment}

> <agenda-title></agenda-title>
>
> In this tutorial, we will cover:
>
> 1. TOC
> {:toc}
>
{: .agenda}

# Maintainer page

Maintaining resources is **fundamental** to the quality and usefulness of any software resource. We do *not* throw code over the wall!

To help topic maintainers to quickly recognise what materials need updating and fixing, **Topic Maintainer Pages** were built.

> <hands-on-title>Go to your topic maintainer page</hands-on-title>
>
> 1. Go to any training topic of interest. This will have the form
> ```
> https://training.galaxyproject.org/training-material/topics/<your topic here>
nomadscientist marked this conversation as resolved.
Show resolved Hide resolved
> ```
> 2. Add a /maintainer to the end of the url.
nomadscientist marked this conversation as resolved.
Show resolved Hide resolved
> ```
> https://training.galaxyproject.org/training-material/topics/<your topic here>/maintainer
> ```
> 3. Explore the maintainer page!
>
{: .hands_on}

{% snippet topics/community/faqs/topic_pages.md %}

You may instantly see some key information missing from tutorials, or how long its been since someone checked it! Time to update some materials!

You can see an example from the Single-cell topic below:

<iframe
src="https://training.galaxyproject.org/training-material/topics/single-cell/maintainer.html"
width="100%"
height="800"
style="border: none;"
title="Single-Cell Topic Maintainer Page">
</iframe>

# Community Page

Where the **Maintainer page** helps you sustain your community, the **Community page** helps you show off your community. An end-of-year gift in 2024, this page will sift through news, events, and GTN contributions for your community tag of interest (example: single-cell) and provide a beautiful visualization of your efforts.

> <hands-on-title>Go to your topic community page</hands-on-title>
>
> 1. Go to any training topic of interest. This will have the form
> ```
> https://training.galaxyproject.org/training-material/topics/<your topic here>
> ```
> 2. Add a /community to the end of the url.
> ```
> https://training.galaxyproject.org/training-material/topics/<your topic here>/community
> ```
> 3. Explore the community page!
>
{: .hands_on}

You can see an example from the Single-cell topic below:

<iframe
src="https://training.galaxyproject.org/training-material/topics/single-cell/community.html"
width="100%"
height="800"
style="border: none;"
title="Single-Cell Topic Community Page">
</iframe>

# Topic usage statistics

Next up, you might want to know how many people are actually using your materials? Welcome to your **Topic usage statistics**! You may have already found this, actually, as it's (currently) at the bottom of the Maintainer page.

> <hands-on-title>Go to your topic usage statistics</hands-on-title>
>
> 1. Go to any training topic of interest. This will have the form
> ```
> https://training.galaxyproject.org/training-material/topics/<your topic here>
> ```
> 2. Add a /community to the end of the url.
> ```
> https://training.galaxyproject.org/training-material/topics/<your topic here>/maintainer.html#statistics-for-your-materials
> ```
> 3. Explore the usage statistics page!
>
{: .hands_on}

You can see an example from the Single-cell topic below.

<iframe
src="https://training.galaxyproject.org/training-material/topics/single-cell/maintainer.html#statistics-for-your-materials"
width="100%"
height="800"
style="border: none;"
title="Single-Cell Topic Usage Statistics">
</iframe>

# News widgets

You can also embed news into your pages, subdomains/ Galaxy Labs, or even your Matrix channels.

Follow this documentation to learn how:

1. [GTN Feeds]( {% link feeds/index.md %} )
2. [Bot integration into matrix]( {% link news/2023/12/20/matrix-bots.md %} )

You can see an example from the Single-cell topic below.

<h3 class="mb-3">News and Events</h3>
<iframe width="100%" height="600px" src="https://training.galaxyproject.org/training-material/feeds/single-cell-month.w.html"></iframe>

# Workflow search

Want to see all the workflows tagged with your community tag across public servers? Look no further!

Follow this documentation to learn how:

1. [Galaxy Pan-Galactic Workflow Search]( {% link workflows/list.md %} )
2. [Workflow Search Querying]( {% link news/2023/11/20/workflow-search.md %} )

You can see an example from the Single-cell topic below.

<h3 class="mb-3">Public workflows</h3>
<iframe src="https://training.galaxyproject.org/training-material/workflows/embed.html?query=single-cell" height="600px" width="100%" class="gtn-embed" frameborder="1"></iframe>

# Conclusion

{% icon congratulations %} Congratulations! You've made it to the end! Hopefully you think these resources are brilliant, and are making sure to tag everything (news, events, training materials, workflows, FAQs, you name it, you should tag it!) with your community tag!
1 change: 1 addition & 0 deletions topics/community/tutorials/sig_create/tutorial.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
---
layout: tutorial_hands_on
priority: 2
subtopic: sig

title: "Creating a Special Interest Group"
questions:
Expand Down
1 change: 1 addition & 0 deletions topics/community/tutorials/sig_define/tutorial.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,7 @@
layout: tutorial_hands_on
priority: 1
title: "What's a Special Interest Group?"
subtopic: sig
questions:
- "What is a Special Interest Group?"
- "What is the purpose of a Special Interest Group?"
Expand Down
9 changes: 5 additions & 4 deletions topics/community/tutorials/tools_subdomains/tutorial.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,7 @@
layout: tutorial_hands_on

title: Make your tools available on your subdomain
subtopic: subdomain
questions:
- How can a tool be added in a section ?
- How can a section be added in a subdomain ?
Expand Down Expand Up @@ -43,15 +44,15 @@ This tutorial explains how to make your brand new tools, once they're published
> - For Galaxy Europe, fork the [usegalaxy-eu-tools repo](https://github.com/usegalaxy-eu/usegalaxy-eu-tools)
> - Create a branch on your fork
> - Browse through the different yaml files and select the one that correspond to your subdomain for earth system everything is made under the ecology owner. The name of the files corresponds to a toolshed owner or community and a few of those communities with a review system and CI integration gets special trust and auto-updates.
> - Once in the yaml you can add the section for your tool (you want to know what are the existing tool sections ? Go check the [categories defined here](https://github.com/usegalaxy-eu/infrastructure-playbook/blob/master/templates/galaxy/config/tool_conf.xml.j2))
>
> - Once in the yaml you can add the section for your tool (you want to know what are the existing tool sections ? Go check the [categories defined here](https://github.com/usegalaxy-eu/infrastructure-playbook/blob/master/templates/galaxy/config/tool_conf.xml.j2))
>
> An example on how to fill in the yaml file
> ```
> - name: id_of_your_tool
> owner: choose_the_owner_relative_to_a_github_repo
> tool_panel_section_label: 'Choose the section where your tool belongs'
> ```
>
>
> ![Image of the modification to make in the ecology.yaml file](../../images/tool_subdomain/ecology_yml_tool.png)
>
> - Then commit your changes and write a nice message for the admin when you open your Pull Request.
Expand Down Expand Up @@ -85,7 +86,7 @@ This part is only to make batch tool visible in your subdomain.
> - Then, commit your changes and write a nice message for the admin when you open your Pull Request.
{: .hands_on}

If you choose to create a new section for your interactive tool don't forget add this section to your subdomain !
If you choose to create a new section for your interactive tool don't forget add this section to your subdomain !

# Conclusion

Expand Down
Loading