Programming.Dev/p.d-blog
Programming.Dev
/
p.d-blog
5
1
Fork 3
Code Issues 4 Pull Requests 1 Projects Activity

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
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

54
.gitea/ISSUE_TEMPLATE/BUG_REPORT.yaml
View File

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

46
.gitea/ISSUE_TEMPLATE/ENHANCEMENT.yaml
View File

@ -1,24 +1,24 @@
name: Enhancement name: Enhancement
description: 🥪 Create an Enhancement Request (enhance existing features) description: 🥪 Create an Enhancement Request (enhance existing features)
labels: ["Kind/🥪 Enhancement"] labels: ["Kind/🥪 Enhancement"]
body: body:
- type: markdown - type: markdown
attributes: attributes:
value: | value: |
Thanks for taking the time to suggest some new enhancements Thanks for taking the time to suggest some new enhancements
- type: checkboxes - type: checkboxes
attributes: attributes:
label: Requirements label: Requirements
description: Before you create an enhancement request, please check the following - description: Before you create an enhancement request, please check the following -
options: 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) - 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 required: true
- label: Make sure It's a single enhancement. Please don't request multiple enhancements in one issue. - label: Make sure It's a single enhancement. Please don't request multiple enhancements in one issue.
required: true required: true
- type: textarea - type: textarea
id: description id: description
attributes: attributes:
label: Describe the enhancement you want label: Describe the enhancement you want
description: Give a good description of what you want added. Also explain why its needed description: Give a good description of what you want added. Also explain why its needed
validations: validations:
required: true required: true

46
.gitea/ISSUE_TEMPLATE/FEATURE_REQUEST.yaml
View File

@ -1,24 +1,24 @@
name: Feature Request name: Feature Request
description: 🍖 Create a Feature Request description: 🍖 Create a Feature Request
labels: ["Kind/🍖 Feature"] labels: ["Kind/🍖 Feature"]
body: body:
- type: markdown - type: markdown
attributes: attributes:
value: | value: |
Thanks for taking the time to suggest some new features Thanks for taking the time to suggest some new features
- type: checkboxes - type: checkboxes
attributes: attributes:
label: Requirements label: Requirements
description: Before you create a feature request, please check the following - description: Before you create a feature request, please check the following -
options: 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) - 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 required: true
- label: Make sure It's a single feature. Please don't request multiple features in one issue. - label: Make sure It's a single feature. Please don't request multiple features in one issue.
required: true required: true
- type: textarea - type: textarea
id: description id: description
attributes: attributes:
label: Describe the feature you want label: Describe the feature you want
description: Give a good description of what you want added. Also explain why its needed description: Give a good description of what you want added. Also explain why its needed
validations: validations:
required: true required: true

38
.gitea/ISSUE_TEMPLATE/POST.yaml
View File

@ -1,20 +1,20 @@
name: Post name: Post
description: 🍉 Create a Post Request description: 🍉 Create a Post Request
labels: ["Kind/🍉 Documentation"] labels: ["Kind/🍉 Documentation"]
body: body:
- type: checkboxes - type: checkboxes
attributes: attributes:
label: Requirements label: Requirements
description: Before you create a post request, please check the following - description: Before you create a post request, please check the following -
options: 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) - 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 required: true
- label: Make sure this is a request for a blog post - label: Make sure this is a request for a blog post
required: true required: true
- type: textarea - type: textarea
id: description id: description
attributes: attributes:
label: Describe the post content that is being requested label: Describe the post content that is being requested
description: Give a good description of what would go into the post description: Give a good description of what would go into the post
validations: validations:
required: true required: true

20
.gitea/ISSUE_TEMPLATE/config.yaml
View File

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

26
.gitignore vendored
View File

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

6
.gitmodules vendored
View File

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

52
README.md
View File

@ -1,26 +1,26 @@
<div align="center"> <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) ![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>
<div align="center"> <div align="center">
<img src="https://git.programming.dev/repo-avatars/10d8e2b35334804de33cc8e3eef6373dc436753b6c1dc0e406e7b6b502f43d4a" width=200px height=200px></img> <img src="https://git.programming.dev/repo-avatars/10d8e2b35334804de33cc8e3eef6373dc436753b6c1dc0e406e7b6b502f43d4a" width=200px height=200px></img>
<h3 align="center"><a href="">P.D Blog</a></h3> <h3 align="center"><a href="">P.D Blog</a></h3>
<p align="center"> <p align="center">
Source code for the official Programming.Dev blog. Source code for the official Programming.Dev blog.
</p> </p>
</div> </div>
## About ## 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. 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 ## Links
- [Site](https://blog.programming.dev) - [Site](https://blog.programming.dev)
- [Main Repo](https://git.programming.dev/Programming.Dev/p.d-blog) - [Main Repo](https://git.programming.dev/Programming.Dev/p.d-blog)
- [Discord](https://discord.gg/JsGUgmXheC) - [Discord](https://discord.gg/JsGUgmXheC)
- [Matrix](https://matrix.to/#/#p.d:matrix.org) - [Matrix](https://matrix.to/#/#p.d:matrix.org)
## Credits ## 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 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

10
archetypes/default.md
View File

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

166
config.yaml
View File

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

14
content/archive.md
View File

@ -1,7 +1,7 @@
--- ---
title: "Archive" title: "Archive"
layout: "archives" layout: "archives"
url: "/archive/" url: "/archive/"
summary: "An archive of all of the posts on the site" summary: "An archive of all of the posts on the site"
description: "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.

28
content/posts/bytes-2023-12-5.md
View File

@ -1,14 +1,14 @@
--- ---
title: "Bytes v2023.12.5 Update" title: "Bytes v2023.12.5 Update"
date: 2024-02-25T23:35:09-05:00 date: 2024-02-25T23:35:09-05:00
author: "Ategon" author: "Ategon"
categories: categories:
- Bytes - Bytes
tags: tags:
- Update - 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. 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.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) - [v2023.12.5 Changelog](https://iceshrimp.dev/iceshrimp/iceshrimp/src/branch/dev/CHANGELOG.md#v2023-12-5)

78
content/posts/frontend-bump-2024-2-25.md
View File

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

70
content/posts/git.md
View File

@ -1,35 +1,35 @@
--- ---
title: "Introducing Forge aka Git.Programming.Dev" title: "Introducing Forge aka Git.Programming.Dev"
date: 2024-02-26T02:47:09-05:00 date: 2024-02-26T02:47:09-05:00
author: "Ategon" author: "Ategon"
categories: categories:
- Forge - Forge
tags: tags:
- Release - 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. 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. 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? ## 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. 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? ## 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. 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. 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. 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? ## 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. 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? ## 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 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. 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.

42
content/posts/me.md
View File

@ -1,21 +1,21 @@
--- ---
title: 'Introducing Me.Programming.Dev' title: 'Introducing Me.Programming.Dev'
date: 2024-02-13T14:45:20-05:00 date: 2024-02-13T14:45:20-05:00
author: 'Ategon' author: 'Ategon'
categories: categories:
- Me - Me
tags: tags:
- Release - 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. 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) You can find the site [here](https://me.programming.dev)
## Custom pages ## 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). 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 ## 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 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? ## 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 :) 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 :)

28
content/posts/welcome-to-stacks.md
View File

@ -1,14 +1,14 @@
--- ---
title: 'Welcome to Stacks!' title: 'Welcome to Stacks!'
date: 2024-02-12T21:15:13-05:00 date: 2024-02-12T21:15:13-05:00
author: 'Ategon' author: 'Ategon'
categories: categories:
- Stacks - Stacks
tags: tags:
- Release - 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). 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! 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 An rss feed is available for inserting into your rss reader at http://stacks.programming.dev/index.xml

60
content/posts/wiki.md
View File

@ -1,31 +1,31 @@
--- ---
title: 'Introducing the P.D Community Wiki' title: 'Introducing the P.D Community Wiki'
date: 2024-02-15T01:09:36-05:00 date: 2024-02-15T01:09:36-05:00
author: 'Ategon' author: 'Ategon'
categories: categories:
- Wiki - Wiki
tags: tags:
- Release - 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. 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) You can find the site [here](https://wiki.programming.dev)
## How does navigation work? ## 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. 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. 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) ![](/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 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? ## 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. 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. 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. Pages are written in markdown.
## Are other languages supported? ## 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. 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.

16
content/search.md
View File

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

166
layouts/_default/rss.xml
View File

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