Add blocks post

This commit is contained in:
Ategon 2024-02-27 23:46:37 -05:00
parent fbb40d1ade
commit da8ab4a12f
20 changed files with 500 additions and 483 deletions

View File

@ -1,28 +1,28 @@
name: Bug Report
description: 🐞 File a bug report
title: "[Bug]: "
labels: ["Kind/🍊 Bug"]
body:
- type: markdown
attributes:
value: |
Thanks for taking the time to fill out this bug report!
- type: textarea
id: what-happened
attributes:
label: What happened?
description: Explain the bug and give images if possible
validations:
required: true
- type: textarea
id: steps
attributes:
label: Steps to Reproduce
description: Walk us through all the steps on how to reproduce your issue
value: |
1.
2.
3.
4.
validations:
name: Bug Report
description: 🐞 File a bug report
title: "[Bug]: "
labels: ["Kind/🍊 Bug"]
body:
- type: markdown
attributes:
value: |
Thanks for taking the time to fill out this bug report!
- type: textarea
id: what-happened
attributes:
label: What happened?
description: Explain the bug and give images if possible
validations:
required: true
- type: textarea
id: steps
attributes:
label: Steps to Reproduce
description: Walk us through all the steps on how to reproduce your issue
value: |
1.
2.
3.
4.
validations:
required: true

View File

@ -1,24 +1,24 @@
name: Enhancement
description: 🥪 Create an Enhancement Request (enhance existing features)
labels: ["Kind/🥪 Enhancement"]
body:
- type: markdown
attributes:
value: |
Thanks for taking the time to suggest some new enhancements
- type: checkboxes
attributes:
label: Requirements
description: Before you create an enhancement request, please check the following -
options:
- label: Check to see if this request already exists [here](https://git.programming.dev/Programming.Dev/p.d-wiki/issues?state=open&labels=3)
required: true
- label: Make sure It's a single enhancement. Please don't request multiple enhancements in one issue.
required: true
- type: textarea
id: description
attributes:
label: Describe the enhancement you want
description: Give a good description of what you want added. Also explain why its needed
validations:
name: Enhancement
description: 🥪 Create an Enhancement Request (enhance existing features)
labels: ["Kind/🥪 Enhancement"]
body:
- type: markdown
attributes:
value: |
Thanks for taking the time to suggest some new enhancements
- type: checkboxes
attributes:
label: Requirements
description: Before you create an enhancement request, please check the following -
options:
- label: Check to see if this request already exists [here](https://git.programming.dev/Programming.Dev/p.d-wiki/issues?state=open&labels=3)
required: true
- label: Make sure It's a single enhancement. Please don't request multiple enhancements in one issue.
required: true
- type: textarea
id: description
attributes:
label: Describe the enhancement you want
description: Give a good description of what you want added. Also explain why its needed
validations:
required: true

View File

@ -1,24 +1,24 @@
name: Feature Request
description: 🍖 Create a Feature Request
labels: ["Kind/🍖 Feature"]
body:
- type: markdown
attributes:
value: |
Thanks for taking the time to suggest some new features
- type: checkboxes
attributes:
label: Requirements
description: Before you create a feature request, please check the following -
options:
- label: Check to see if this request already exists [here](https://git.programming.dev/Programming.Dev/p.d-wiki/issues?state=open&labels=2)
required: true
- label: Make sure It's a single feature. Please don't request multiple features in one issue.
required: true
- type: textarea
id: description
attributes:
label: Describe the feature you want
description: Give a good description of what you want added. Also explain why its needed
validations:
name: Feature Request
description: 🍖 Create a Feature Request
labels: ["Kind/🍖 Feature"]
body:
- type: markdown
attributes:
value: |
Thanks for taking the time to suggest some new features
- type: checkboxes
attributes:
label: Requirements
description: Before you create a feature request, please check the following -
options:
- label: Check to see if this request already exists [here](https://git.programming.dev/Programming.Dev/p.d-wiki/issues?state=open&labels=2)
required: true
- label: Make sure It's a single feature. Please don't request multiple features in one issue.
required: true
- type: textarea
id: description
attributes:
label: Describe the feature you want
description: Give a good description of what you want added. Also explain why its needed
validations:
required: true

View File

@ -1,20 +1,20 @@
name: Post
description: 🍉 Create a Post Request
labels: ["Kind/🍉 Documentation"]
body:
- type: checkboxes
attributes:
label: Requirements
description: Before you create a post request, please check the following -
options:
- label: Check to see if this request already exists [here](https://git.programming.dev/Programming.Dev/p.d-wiki/issues?state=open&labels=7)
required: true
- label: Make sure this is a request for a blog post
required: true
- type: textarea
id: description
attributes:
label: Describe the post content that is being requested
description: Give a good description of what would go into the post
validations:
name: Post
description: 🍉 Create a Post Request
labels: ["Kind/🍉 Documentation"]
body:
- type: checkboxes
attributes:
label: Requirements
description: Before you create a post request, please check the following -
options:
- label: Check to see if this request already exists [here](https://git.programming.dev/Programming.Dev/p.d-wiki/issues?state=open&labels=7)
required: true
- label: Make sure this is a request for a blog post
required: true
- type: textarea
id: description
attributes:
label: Describe the post content that is being requested
description: Give a good description of what would go into the post
validations:
required: true

View File

@ -1,11 +1,11 @@
blank_issues_enabled: false
contact_links:
- name: Programming.Dev Matrix Space
url: https://matrix.to/#/#p.d:matrix.org
about: For general chatting about programming.dev
- name: Programming.Dev Discord
url: https://discord.gg/PkdaMKsRQ9
about: For general chatting about programming.dev
- name: Email
url: mailto:info@programming.dev
blank_issues_enabled: false
contact_links:
- name: Programming.Dev Matrix Space
url: https://matrix.to/#/#p.d:matrix.org
about: For general chatting about programming.dev
- name: Programming.Dev Discord
url: https://discord.gg/PkdaMKsRQ9
about: For general chatting about programming.dev
- name: Email
url: mailto:info@programming.dev
about: Email the programming.dev team

26
.gitignore vendored
View File

@ -1,13 +1,13 @@
# Generated files by hugo
/public/
/resources/_gen/
/assets/jsconfig.json
hugo_stats.json
# Executable may be added to repository
hugo.exe
hugo.darwin
hugo.linux
# Temporary lock file while building
/.hugo_build.lock
# Generated files by hugo
/public/
/resources/_gen/
/assets/jsconfig.json
hugo_stats.json
# Executable may be added to repository
hugo.exe
hugo.darwin
hugo.linux
# Temporary lock file while building
/.hugo_build.lock

6
.gitmodules vendored
View File

@ -1,3 +1,3 @@
[submodule "themes/PaperMod"]
path = themes/PaperMod
url = https://github.com/adityatelange/hugo-PaperMod.git
[submodule "themes/PaperMod"]
path = themes/PaperMod
url = https://github.com/adityatelange/hugo-PaperMod.git

View File

@ -1,26 +1,26 @@
<div align="center">
![Stars](https://img.shields.io/gitea/stars/Programming.Dev/p.d-blog.svg?style=for-the-badge&gitea_url=https://git.programming.dev)
</div>
<div align="center">
<img src="https://git.programming.dev/repo-avatars/10d8e2b35334804de33cc8e3eef6373dc436753b6c1dc0e406e7b6b502f43d4a" width=200px height=200px></img>
<h3 align="center"><a href="">P.D Blog</a></h3>
<p align="center">
Source code for the official Programming.Dev blog.
</p>
</div>
## About
The Programming.Dev blog is a place where news relating to programming.dev instances including announcements, release notes, community showcases, and more are posted.
## Links
- [Site](https://blog.programming.dev)
- [Main Repo](https://git.programming.dev/Programming.Dev/p.d-blog)
- [Discord](https://discord.gg/JsGUgmXheC)
- [Matrix](https://matrix.to/#/#p.d:matrix.org)
## Credits
Icon base by [Lorc](https://lorcblog.blogspot.com/) under [CC BY 3.0](https://creativecommons.org/licenses/by/3.0/) with modifications to add a gradient
<div align="center">
![Stars](https://img.shields.io/gitea/stars/Programming.Dev/p.d-blog.svg?style=for-the-badge&gitea_url=https://git.programming.dev)
</div>
<div align="center">
<img src="https://git.programming.dev/repo-avatars/10d8e2b35334804de33cc8e3eef6373dc436753b6c1dc0e406e7b6b502f43d4a" width=200px height=200px></img>
<h3 align="center"><a href="">P.D Blog</a></h3>
<p align="center">
Source code for the official Programming.Dev blog.
</p>
</div>
## About
The Programming.Dev blog is a place where news relating to programming.dev instances including announcements, release notes, community showcases, and more are posted.
## Links
- [Site](https://blog.programming.dev)
- [Main Repo](https://git.programming.dev/Programming.Dev/p.d-blog)
- [Discord](https://discord.gg/JsGUgmXheC)
- [Matrix](https://matrix.to/#/#p.d:matrix.org)
## Credits
Icon base by [Lorc](https://lorcblog.blogspot.com/) under [CC BY 3.0](https://creativecommons.org/licenses/by/3.0/) with modifications to add a gradient

View File

@ -1,5 +1,5 @@
---
title: '{{ replace .File.ContentBaseName "-" " " | title }}'
date: {{ .Date }}
draft: true
---
---
title: '{{ replace .File.ContentBaseName "-" " " | title }}'
date: {{ .Date }}
draft: true
---

View File

@ -1,83 +1,83 @@
# Config
baseURL: https://stacks.programming.dev/
languageCode: en-us
title: Stacks
theme: ["PaperMod"]
copyright: "© 2024 Programming.Dev"
defaultTheme: auto
contentDir: 'content'
outputs:
home:
- HTML
- RSS
- JSON
# Menu
menu:
main:
- identifier: categories
name: Categories
url: /categories
weight: 40
- identifier: tags
name: Tags
url: /tags
weight: 30
- identifier: archive
name: Archive
url: /archive
weight: 10
- identifier: search
name: Search
url: /search
weight: 20
params:
env: 'production'
# General
ShowRssButtonInSectionTermList: true
ShowFullTextinRSS: true
# Posts
showReadingTime: true
showToc: true
showBreadCrumbs: true
showCodeCopyButtons: true
showPostNavLinks: true
enableEmoji: true
# Misc
images: ["logo.png"]
# Label
label:
text: "Stacks"
icon: "/logo.png"
iconHeight: 35
# Home Page
homeInfoParams:
Title: 📚 Stacks
Content: Welcome to the official blog for Programming.Dev! Here we post things relating to our instances including announcements, release notes, community showcases, and more.
socialIcons:
- name: "GitHub"
url: "https://github.com/programming-dot-dev"
- name: "Discord"
url: "https://discord.gg/SnUk3bKkNC"
- name: "Matrix"
url: "https://matrix.to/#/#p.d:matrix.org"
- name: "Links"
url: "https://me.programming.dev"
- name: "RSS"
url: "https://stacks.programming.dev/index.xml"
# Search
fuseOpts:
isCaseSensitive: false
shouldSort: true
location: 0
distance: 1000
threshold: 0.4
minMatchCharLength: 0
keys: ["title", "permalink", "summary", "content"]
# Config
baseURL: https://stacks.programming.dev/
languageCode: en-us
title: Stacks
theme: ["PaperMod"]
copyright: "© 2024 Programming.Dev"
defaultTheme: auto
contentDir: 'content'
outputs:
home:
- HTML
- RSS
- JSON
# Menu
menu:
main:
- identifier: categories
name: Categories
url: /categories
weight: 40
- identifier: tags
name: Tags
url: /tags
weight: 30
- identifier: archive
name: Archive
url: /archive
weight: 10
- identifier: search
name: Search
url: /search
weight: 20
params:
env: 'production'
# General
ShowRssButtonInSectionTermList: true
ShowFullTextinRSS: true
# Posts
showReadingTime: true
showToc: true
showBreadCrumbs: true
showCodeCopyButtons: true
showPostNavLinks: true
enableEmoji: true
# Misc
images: ["logo.png"]
# Label
label:
text: "Stacks"
icon: "/logo.png"
iconHeight: 35
# Home Page
homeInfoParams:
Title: 📚 Stacks
Content: Welcome to the official blog for Programming.Dev! Here we post things relating to our instances including announcements, release notes, community showcases, and more.
socialIcons:
- name: "GitHub"
url: "https://github.com/programming-dot-dev"
- name: "Discord"
url: "https://discord.gg/SnUk3bKkNC"
- name: "Matrix"
url: "https://matrix.to/#/#p.d:matrix.org"
- name: "Links"
url: "https://me.programming.dev"
- name: "RSS"
url: "https://stacks.programming.dev/index.xml"
# Search
fuseOpts:
isCaseSensitive: false
shouldSort: true
location: 0
distance: 1000
threshold: 0.4
minMatchCharLength: 0
keys: ["title", "permalink", "summary", "content"]

View File

@ -1,7 +1,7 @@
---
title: "Archive"
layout: "archives"
url: "/archive/"
summary: "An archive of all of the posts on the site"
description: "An archive of all of the posts on the site"
---
---
title: "Archive"
layout: "archives"
url: "/archive/"
summary: "An archive of all of the posts on the site"
description: "An archive of all of the posts on the site"
---

17
content/posts/blocks.md Normal file
View File

@ -0,0 +1,17 @@
---
title: 'Introducing Blocks.Programming.Dev! Code snippet sharing'
date: 2024-02-27T23:38:32-05:00
author: "Ategon"
categories:
- Blocks
tags:
- Release
---
Introducing blocks.programming.dev! This is a site to add small code snippets you make for sharing easily in threads in programming.dev if you need to do something like put the same code in multiple spots.
The site is running using software called opengist and is essentially an equivalent to gists in github. Repo for it is here https://github.com/thomiceli/opengist.
Snippets are accessible both in the web interface and using git if you prefer adding in code from your text editor and then pushing it.
You can find the site here: https://blocks.programming.dev.

View File

@ -1,14 +1,14 @@
---
title: "Bytes v2023.12.5 Update"
date: 2024-02-25T23:35:09-05:00
author: "Ategon"
categories:
- Bytes
tags:
- Update
---
The bytes.programming.dev site has been updated two versions to now be version v2023.12.5. Both of these versions are security fixes for various things on the site.
- [v2023.12.4 Changelog](https://iceshrimp.dev/iceshrimp/iceshrimp/src/branch/dev/CHANGELOG.md#v2023-12-4)
- [v2023.12.5 Changelog](https://iceshrimp.dev/iceshrimp/iceshrimp/src/branch/dev/CHANGELOG.md#v2023-12-5)
---
title: "Bytes v2023.12.5 Update"
date: 2024-02-25T23:35:09-05:00
author: "Ategon"
categories:
- Bytes
tags:
- Update
---
The bytes.programming.dev site has been updated two versions to now be version v2023.12.5. Both of these versions are security fixes for various things on the site.
- [v2023.12.4 Changelog](https://iceshrimp.dev/iceshrimp/iceshrimp/src/branch/dev/CHANGELOG.md#v2023-12-4)
- [v2023.12.5 Changelog](https://iceshrimp.dev/iceshrimp/iceshrimp/src/branch/dev/CHANGELOG.md#v2023-12-5)

View File

@ -1,39 +1,39 @@
---
title: "Voyager and Mlmym Frontend Updates (2024-02-25)"
date: 2024-02-25T23:48:09-05:00
author: "Ategon"
categories:
- Voyager
- Mlmym
tags:
- Update
- Alternate Frontend
---
Two of our programming.dev alternate frontends have been updated to their most recent versions.
## Voyager (v.programming.dev)
Has been updated from version 1.37.4 -> 1.41.0
Main changes:
- You can long press on comments/posts to get the more actions sheet
- Gifs can be configured to autoplay always, never, or on wifi
- When tapping into a post the video continues to play seamlessly
- Videos in the feed have a mute icon you can toggle
- You can now hide self-post thumbnails in compact mode
- You can now set it so you always need to tap to reveal child comments
- Large post voting buttons can be hidden
- Community icons can be hidden
- Link creation now has a dialog for entering link info
- Subscript and superscript support for markdown
- You can now long press usernames to block
## Mlmym (old.programming.dev)
Has been updated from version 0.0.36 -> 0.0.38
Main changes:
- Image uploads has been fixed
---
title: "Voyager and Mlmym Frontend Updates (2024-02-25)"
date: 2024-02-25T23:48:09-05:00
author: "Ategon"
categories:
- Voyager
- Mlmym
tags:
- Update
- Alternate Frontend
---
Two of our programming.dev alternate frontends have been updated to their most recent versions.
## Voyager (v.programming.dev)
Has been updated from version 1.37.4 -> 1.41.0
Main changes:
- You can long press on comments/posts to get the more actions sheet
- Gifs can be configured to autoplay always, never, or on wifi
- When tapping into a post the video continues to play seamlessly
- Videos in the feed have a mute icon you can toggle
- You can now hide self-post thumbnails in compact mode
- You can now set it so you always need to tap to reveal child comments
- Large post voting buttons can be hidden
- Community icons can be hidden
- Link creation now has a dialog for entering link info
- Subscript and superscript support for markdown
- You can now long press usernames to block
## Mlmym (old.programming.dev)
Has been updated from version 0.0.36 -> 0.0.38
Main changes:
- Image uploads has been fixed

View File

@ -1,35 +1,35 @@
---
title: "Introducing Forge aka Git.Programming.Dev"
date: 2024-02-26T02:47:09-05:00
author: "Ategon"
categories:
- Forge
tags:
- Release
---
Introducing a new supporting site for the instance, git.programming.dev aka Forge! This is a spot where development on things relating to the instance will be taking place. This includes for each thing having source code, task boards, and issue trackers viewable.
This gives us a spot away from GitHub so we don't have to rely on them for hosting our code. In addition, Forgejo, the software used, is working on federation so eventually features could be implemented to do things such as interact with Forge directly from our instances.
## Who is allowed to make an account?
Anyone is free to make an account on the site provided you have not broken our code of conduct and have gotten banned from one of the instances.
## What is allowed to be hosted?
Any code that relates to things we do on the fediverse or outside the fediverse but relating to programming.dev is allowed to be hosted on Forge. This includes things such as bots made for lemmy/sublinks, alternate frontends, software we host, tools, etc.
As an example alternate frontends like photon, alexandrite, etc. are free to choose to be hosted on Forge. Software such as Sublinks, etc. can be hosted, and various misc bots and tools such as Fediseer, Automod, etc. can be hosted.
Anything hosted on forge must be able to support the programming.dev instance it is built around. This means that things like bots and alternate frontends for the programming.dev instance must be able to support sublinks.
## How can I make an organization on Forge?
If you want an organization on Forge to group a collection of repos together feel free to reach out to one of the team leads or email info@programming.dev.
## How can I contribute to a programming.dev repo?
If you want to contribute code feel free to fork the relevant repo and then make a pull request back to it with the changes. If you have an idea for something that can be added to a platform or a bug report open up an issue on the relevant repo in the Programming.Dev org.
If you're interested in contributing a large amount to the programming.dev repos feel free to reach out to me (Ategon) on discord or matrix or email info@programming.dev and I can add you to the development team.
---
title: "Introducing Forge aka Git.Programming.Dev"
date: 2024-02-26T02:47:09-05:00
author: "Ategon"
categories:
- Forge
tags:
- Release
---
Introducing a new supporting site for the instance, git.programming.dev aka Forge! This is a spot where development on things relating to the instance will be taking place. This includes for each thing having source code, task boards, and issue trackers viewable.
This gives us a spot away from GitHub so we don't have to rely on them for hosting our code. In addition, Forgejo, the software used, is working on federation so eventually features could be implemented to do things such as interact with Forge directly from our instances.
## Who is allowed to make an account?
Anyone is free to make an account on the site provided you have not broken our code of conduct and have gotten banned from one of the instances.
## What is allowed to be hosted?
Any code that relates to things we do on the fediverse or outside the fediverse but relating to programming.dev is allowed to be hosted on Forge. This includes things such as bots made for lemmy/sublinks, alternate frontends, software we host, tools, etc.
As an example alternate frontends like photon, alexandrite, etc. are free to choose to be hosted on Forge. Software such as Sublinks, etc. can be hosted, and various misc bots and tools such as Fediseer, Automod, etc. can be hosted.
Anything hosted on forge must be able to support the programming.dev instance it is built around. This means that things like bots and alternate frontends for the programming.dev instance must be able to support sublinks.
## How can I make an organization on Forge?
If you want an organization on Forge to group a collection of repos together feel free to reach out to one of the team leads or email info@programming.dev.
## How can I contribute to a programming.dev repo?
If you want to contribute code feel free to fork the relevant repo and then make a pull request back to it with the changes. If you have an idea for something that can be added to a platform or a bug report open up an issue on the relevant repo in the Programming.Dev org.
If you're interested in contributing a large amount to the programming.dev repos feel free to reach out to me (Ategon) on discord or matrix or email info@programming.dev and I can add you to the development team.

View File

@ -1,21 +1,21 @@
---
title: 'Introducing Me.Programming.Dev'
date: 2024-02-13T14:45:20-05:00
author: 'Ategon'
categories:
- Me
tags:
- Release
---
We have a brand new supporting site for the instances! Me.Programming.Dev is a place where you can see relevant links for things we host. Listed are software we are hosting, status pages, alternate frontends, and more.
You can find the site [here](https://me.programming.dev)
## Custom pages
The site is a self-hosted linkstack instance so as a little thank you towards donators, donators are able to get a custom page to put socials on. You can see an example of that over on my page at https://me.programming.dev/@Ategon. If you want a page and you've donated just reach out to me (Ategon).
## Adding links
As new instances and sites get made new links will be popping up over on the site. I recommend checking it out for new things every once in awhile just in case you miss an announcement on something new were releasing
## Whats this instance I don't recognize?
You may notice theres something we haven't announced yet on there. Left it in as a little early access for those reading our update posts before it releases later this week. Feel free to make an account and check it out before the floodgates open :)
---
title: 'Introducing Me.Programming.Dev'
date: 2024-02-13T14:45:20-05:00
author: 'Ategon'
categories:
- Me
tags:
- Release
---
We have a brand new supporting site for the instances! Me.Programming.Dev is a place where you can see relevant links for things we host. Listed are software we are hosting, status pages, alternate frontends, and more.
You can find the site [here](https://me.programming.dev)
## Custom pages
The site is a self-hosted linkstack instance so as a little thank you towards donators, donators are able to get a custom page to put socials on. You can see an example of that over on my page at https://me.programming.dev/@Ategon. If you want a page and you've donated just reach out to me (Ategon).
## Adding links
As new instances and sites get made new links will be popping up over on the site. I recommend checking it out for new things every once in awhile just in case you miss an announcement on something new were releasing
## Whats this instance I don't recognize?
You may notice theres something we haven't announced yet on there. Left it in as a little early access for those reading our update posts before it releases later this week. Feel free to make an account and check it out before the floodgates open :)

View File

@ -1,14 +1,14 @@
---
title: 'Welcome to Stacks!'
date: 2024-02-12T21:15:13-05:00
author: 'Ategon'
categories:
- Stacks
tags:
- Release
---
Stacks is the official blog for Programming.Dev! This is a place where we will share news, announcements, upgrades, etc. relating to any instances we host such as programming.dev (and the new instance coming soon).
There should be many new releases coming out and being announced here over the next month as things that have been getting made start finishing up!
An rss feed is available for inserting into your rss reader at http://stacks.programming.dev/index.xml
---
title: 'Welcome to Stacks!'
date: 2024-02-12T21:15:13-05:00
author: 'Ategon'
categories:
- Stacks
tags:
- Release
---
Stacks is the official blog for Programming.Dev! This is a place where we will share news, announcements, upgrades, etc. relating to any instances we host such as programming.dev (and the new instance coming soon).
There should be many new releases coming out and being announced here over the next month as things that have been getting made start finishing up!
An rss feed is available for inserting into your rss reader at http://stacks.programming.dev/index.xml

View File

@ -1,31 +1,31 @@
---
title: 'Introducing the P.D Community Wiki'
date: 2024-02-15T01:09:36-05:00
author: 'Ategon'
categories:
- Wiki
tags:
- Release
---
Introducing the Programming.Dev community wiki. This is a place where communities can set up wiki pages for their communities to allow people to easily get info relating to it.
You can find the site [here](https://wiki.programming.dev)
## How does navigation work?
The home page has a list of communities with pages. If you click on a community it will bring you to their list of documents that you can look through.
Some possible use cases for a community wiki are: a code of conduct page, a frequently asked questions page, information about the community, credits if you need to credit things such as your community icon, a page for related communities, etc.
![](/wiki.png)
Ive set up a couple example pages to start. The gamedev section of the site has 6 different pages that you can look through to set some ideas
## How do I edit a page?
Editing is handled through git. Each page will have an edit this page button that will bring you to a page where you can fork the repository, make changes, and then make a pull request to get it accepted into the site.
The pages all reside in the content/docs folder while the sidebars are in content/menus. You can see how I set up some of the current pages for how to format things.
Pages are written in markdown.
## Are other languages supported?
---
title: 'Introducing the P.D Community Wiki'
date: 2024-02-15T01:09:36-05:00
author: 'Ategon'
categories:
- Wiki
tags:
- Release
---
Introducing the Programming.Dev community wiki. This is a place where communities can set up wiki pages for their communities to allow people to easily get info relating to it.
You can find the site [here](https://wiki.programming.dev)
## How does navigation work?
The home page has a list of communities with pages. If you click on a community it will bring you to their list of documents that you can look through.
Some possible use cases for a community wiki are: a code of conduct page, a frequently asked questions page, information about the community, credits if you need to credit things such as your community icon, a page for related communities, etc.
![](/wiki.png)
Ive set up a couple example pages to start. The gamedev section of the site has 6 different pages that you can look through to set some ideas
## How do I edit a page?
Editing is handled through git. Each page will have an edit this page button that will bring you to a page where you can fork the repository, make changes, and then make a pull request to get it accepted into the site.
The pages all reside in the content/docs folder while the sidebars are in content/menus. You can see how I set up some of the current pages for how to format things.
Pages are written in markdown.
## Are other languages supported?
Yes! Currently theres only english set up as we don't really have communities in other languages but it would be easy to add more language options in the site config.

View File

@ -1,8 +1,8 @@
---
title: "Search" # in any language you want
layout: "search" # necessary for search
description: "Search the site for something"
placeholder: "enter text here..."
summary: "Search the site for something"
---
---
title: "Search" # in any language you want
layout: "search" # necessary for search
description: "Search the site for something"
placeholder: "enter text here..."
summary: "Search the site for something"
---

View File

@ -1,83 +1,83 @@
{{- /* Deprecate site.Author.email in favor of site.Params.author.email */}}
{{- $authorEmail := "" }}
{{- with site.Params.author }}
{{- if reflect.IsMap . }}
{{- with .email }}
{{- $authorEmail = . }}
{{- end }}
{{- end }}
{{- else }}
{{- with site.Author.email }}
{{- $authorEmail = . }}
{{- warnf "The author key in site configuration is deprecated. Use params.author.email instead." }}
{{- end }}
{{- end }}
{{- /* Deprecate site.Author.name in favor of site.Params.author.name */}}
{{- $authorName := "" }}
{{- with site.Params.author }}
{{- if reflect.IsMap . }}
{{- with .name }}
{{- $authorName = . }}
{{- end }}
{{- else }}
{{- $authorName = . }}
{{- end }}
{{- else }}
{{- with site.Author.name }}
{{- $authorName = . }}
{{- warnf "The author key in site configuration is deprecated. Use params.author.name instead." }}
{{- end }}
{{- end }}
{{- $pctx := . }}
{{- if .IsHome }}{{ $pctx = site }}{{ end }}
{{- $pages := slice }}
{{- if or $.IsHome $.IsSection }}
{{- $pages = $pctx.RegularPages }}
{{- else }}
{{- $pages = $pctx.Pages }}
{{- end }}
{{- $limit := site.Config.Services.RSS.Limit }}
{{- if ge $limit 1 }}
{{- $pages = $pages | first $limit }}
{{- end }}
{{- printf "<?xml version=\"1.0\" encoding=\"utf-8\" standalone=\"yes\"?>" | safeHTML }}
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:content="http://purl.org/rss/1.0/modules/content/">
<channel>
<title>{{ if eq .Title site.Title }}{{ site.Title }}{{ else }}{{ with .Title }}{{ . }} on {{ end }}{{ site.Title }}{{ end }}</title>
<link>{{ .Permalink }}</link>
<description>Recent content {{ if ne .Title site.Title }}{{ with .Title }}in {{ . }} {{ end }}{{ end }}on {{ site.Title }}</description>
{{- with site.Params.images }}
<image>
<title>{{ site.Title }}</title>
<url>{{ index . 0 | absURL }}</url>
<link>{{ index . 0 | absURL }}</link>
</image>
{{- end }}
<generator>Hugo -- gohugo.io</generator>
<language>{{ site.LanguageCode }}</language>{{ with $authorEmail }}
<managingEditor>{{.}}{{ with $authorName }} ({{ . }}){{ end }}</managingEditor>{{ end }}{{ with $authorEmail }}
<webMaster>{{ . }}{{ with $authorName }} ({{ . }}){{ end }}</webMaster>{{ end }}{{ with site.Copyright }}
<copyright>{{ . }}</copyright>{{ end }}{{ if not .Date.IsZero }}
<lastBuildDate>{{ (index $pages.ByLastmod.Reverse 0).Lastmod.Format "Mon, 02 Jan 2006 15:04:05 -0700" | safeHTML }}</lastBuildDate>{{ end }}
{{- with .OutputFormats.Get "RSS" }}
{{ printf "<atom:link href=%q rel=\"self\" type=%q />" .Permalink .MediaType | safeHTML }}
{{- end }}
{{- range $pages }}
{{- if and (ne .Layout `search`) (ne .Layout `archives`) }}
<item>
<title>{{ .Title }}</title>
<link>{{ .Permalink }}</link>
<pubDate>{{ .Date.Format "Mon, 02 Jan 2006 15:04:05 -0700" | safeHTML }}</pubDate>
{{- with $authorEmail }}<author>{{ . }}{{ with $authorName }} ({{ . }}){{ end }}</author>{{ end }}
<guid>{{ .Permalink }}</guid>
<description>{{ with .Description | html }}{{ . }}{{ else }}{{ .Summary | html }}{{ end -}}</description>
{{- if and site.Params.ShowFullTextinRSS .Content }}
<content:encoded>{{ (printf "<![CDATA[%s]]>" .Content) | safeHTML }}</content:encoded>
{{- end }}
</item>
{{- end }}
{{- end }}
</channel>
</rss>
{{- /* Deprecate site.Author.email in favor of site.Params.author.email */}}
{{- $authorEmail := "" }}
{{- with site.Params.author }}
{{- if reflect.IsMap . }}
{{- with .email }}
{{- $authorEmail = . }}
{{- end }}
{{- end }}
{{- else }}
{{- with site.Author.email }}
{{- $authorEmail = . }}
{{- warnf "The author key in site configuration is deprecated. Use params.author.email instead." }}
{{- end }}
{{- end }}
{{- /* Deprecate site.Author.name in favor of site.Params.author.name */}}
{{- $authorName := "" }}
{{- with site.Params.author }}
{{- if reflect.IsMap . }}
{{- with .name }}
{{- $authorName = . }}
{{- end }}
{{- else }}
{{- $authorName = . }}
{{- end }}
{{- else }}
{{- with site.Author.name }}
{{- $authorName = . }}
{{- warnf "The author key in site configuration is deprecated. Use params.author.name instead." }}
{{- end }}
{{- end }}
{{- $pctx := . }}
{{- if .IsHome }}{{ $pctx = site }}{{ end }}
{{- $pages := slice }}
{{- if or $.IsHome $.IsSection }}
{{- $pages = $pctx.RegularPages }}
{{- else }}
{{- $pages = $pctx.Pages }}
{{- end }}
{{- $limit := site.Config.Services.RSS.Limit }}
{{- if ge $limit 1 }}
{{- $pages = $pages | first $limit }}
{{- end }}
{{- printf "<?xml version=\"1.0\" encoding=\"utf-8\" standalone=\"yes\"?>" | safeHTML }}
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:content="http://purl.org/rss/1.0/modules/content/">
<channel>
<title>{{ if eq .Title site.Title }}{{ site.Title }}{{ else }}{{ with .Title }}{{ . }} on {{ end }}{{ site.Title }}{{ end }}</title>
<link>{{ .Permalink }}</link>
<description>Recent content {{ if ne .Title site.Title }}{{ with .Title }}in {{ . }} {{ end }}{{ end }}on {{ site.Title }}</description>
{{- with site.Params.images }}
<image>
<title>{{ site.Title }}</title>
<url>{{ index . 0 | absURL }}</url>
<link>{{ index . 0 | absURL }}</link>
</image>
{{- end }}
<generator>Hugo -- gohugo.io</generator>
<language>{{ site.LanguageCode }}</language>{{ with $authorEmail }}
<managingEditor>{{.}}{{ with $authorName }} ({{ . }}){{ end }}</managingEditor>{{ end }}{{ with $authorEmail }}
<webMaster>{{ . }}{{ with $authorName }} ({{ . }}){{ end }}</webMaster>{{ end }}{{ with site.Copyright }}
<copyright>{{ . }}</copyright>{{ end }}{{ if not .Date.IsZero }}
<lastBuildDate>{{ (index $pages.ByLastmod.Reverse 0).Lastmod.Format "Mon, 02 Jan 2006 15:04:05 -0700" | safeHTML }}</lastBuildDate>{{ end }}
{{- with .OutputFormats.Get "RSS" }}
{{ printf "<atom:link href=%q rel=\"self\" type=%q />" .Permalink .MediaType | safeHTML }}
{{- end }}
{{- range $pages }}
{{- if and (ne .Layout `search`) (ne .Layout `archives`) }}
<item>
<title>{{ .Title }}</title>
<link>{{ .Permalink }}</link>
<pubDate>{{ .Date.Format "Mon, 02 Jan 2006 15:04:05 -0700" | safeHTML }}</pubDate>
{{- with $authorEmail }}<author>{{ . }}{{ with $authorName }} ({{ . }}){{ end }}</author>{{ end }}
<guid>{{ .Permalink }}</guid>
<description>{{ with .Description | html }}{{ . }}{{ else }}{{ .Summary | html }}{{ end -}}</description>
{{- if and site.Params.ShowFullTextinRSS .Content }}
<content:encoded>{{ (printf "<![CDATA[%s]]>" .Content) | safeHTML }}</content:encoded>
{{- end }}
</item>
{{- end }}
{{- end }}
</channel>
</rss>