this is sample text (playground) ## Test Articles - [playground](./[playground]) - [playground (full theme)](./[playground-full]) - [playground (no theme)](./[playground-gm3]) - [p3](./[playground-p3]) - [totk](./[playground-totk]) # Markdown Test Document This document is designed to test all aspects of the pagex Markdown renderer. To modify the test document, make changes in `/src/content/articles/playground/content.md`. ## Media Player Playground The media player allows playback of YouTube videos. ```html ``` ### Same Video ID as the last entry above ## Custom Elements Voidcannon provides a set of custom html elements that can be used within the standard markdown html syntax. ### <voidcannon-carousel> `` turns any content into a carousel. Carousels are not server-rendered. ![Persona 5 Menu](media/menu.jpg "p5 menu") ![Persona 5 Protagonist](media/joker.jpg "p5 joker") ![Persona 5 Enemy](media/enemy.jpg "p5 enemy") ```markdown ![Persona 5 Menu](media/menu.jpg "p5 menu") ![Persona 5 Protagonist](media/joker.jpg "p5 joker") ![Persona 5 Enemy](media/enemy.jpg "p5 enemy") ``` ### <voidcannon-slide>, <voidcannon-harness> The `` and `` custom elements allow for slotting content. #### <voidcannon-slide> Intended for use within carousels in order to create holding containers for slides. Automatically scales images to use up all available visual carousel space. Will probably be replaced in favor of harness some day. ```markdown ![Persona 5 Enemy](media/enemy.jpg "p5 enemy") ``` #### <voidcannon-harness> Makes content take up more space horizontally in the article layout. Intended for big elements like images or important sections that should get more highlighting or emphasis. (Carousels use this style by default without needing a harness element) ```markdown ![Cat using computer](assets/Cat_using_computer.jpg "look at this cat") ``` ### <voidcannon-cta> Call-to-action that emphasizes an action or acts as a callout/hint. Can accept a button. brightness_alert Big Warning! Go to Warner ```html brightness_alert Big Warning! Go to Warner ``` ## Other Custom Elements The voidcannon frontend imports various other internal and external custom elements that can be server-rendered. ### @material/web Buttons warning breaking_news > Voidcannon ships a stripped down version of Material Symbols in production builds. > > If an icon doesn't display properly in `` or `` components, make > sure the icon is included in `voidcannon/scripts/generate-icon-font.js`. ### gm3 (1p) --- To get an exhaustive list, check `voidcannon/src/client/components.js`. Client-only components are under `voidcannon/src/client/components_client.js`. ## Headings # H1 Heading ## H2 Heading ### H3 Heading #### H4 Heading ##### H5 Heading ###### H6 Heading ## Emphasis * **Bold text** * *Italic text* * ***Bold and italic text*** * ~~Strikethrough text~~ * Underlined text (if supported) ## Lists ### Unordered Lists Unordered Lists get little Material 3 Expressive shapes as their markers. * Item 1 * Item 2 * Subitem 1 * Subitem 2 * Item 3 * Item 4 * Item 5 * Item 6 * Item 7 * Item 8 * Item 9 * Item 10 * Item 11 * Item 12 * Item 13 * Item 14 * Item 15 * Item 16 * Item 17 * Item 18 ### Ordered Lists 1. First item 2. Second item 1. Subitem 1 2. Subitem 2 3. Third item ## Emojis # 🦭 big seal My favourite animals are the seal 🦭 and the otter 🦦. My favourite emoji is the skateboard 🛹 joycat 😹 🌈 ✨🤩💫☪🐟♏🦂🦀🦁🐍🐐🌃🍋‍🟩🍒 - 🏃🏾‍♀️‍➡️ - 👨🏻‍❤️‍👨🏻 - 🧑🏼‍❤️‍🧑🏾 - 🫩 - 🇩🇪 First-Party Custom emoji - :p3smile: :p3worried: :p3surprised: - `:p3smile: :p3worried: :p3surprised:` - :p3arrowup: :p3heart: :p3brokenheart: :p3burger: :p3camera: :p3cat: :p3dog: :p3cloud: :p3cup: :p3moon: :p3fullmoon: :p3pill: :p3rainbow: :p3snowman: :p3star: :p3sun: :p3thumbsup: :p3umbrella: :p3yen: - `:p3arrowup: :p3heart: :p3brokenheart: :p3burger: :p3camera: :p3cat: :p3dog: :p3cloud: :p3cup: :p3moon: :p3fullmoon: :p3pill: :p3rainbow: :p3snowman: :p3star: :p3sun: :p3thumbsup: :p3umbrella: :p3yen:` warning Check pagex_commons for details on how to add custom emoji. Supports discord-style shorthands - :tada: (`:tada:`) - :heart_hands::skin-tone-1: (`:heart_hands::skin-tone-1:`) - :couple_with_heart_person_person_medium_light_skin_tone_medium_dark_skin_tone: (`:couple_with_heart_person_person_medium_light_skin_tone_medium_dark_skin_tone:`) - :person_in_motorized_wheelchair_facing_right_medium_light_skin_tone: (`:person_in_motorized_wheelchair_facing_right_medium_light_skin_tone:`) - :regional_indicator_b::regional_indicator_i::regional_indicator_g::regional_indicator_n::regional_indicator_u::regional_indicator_t::regional_indicator_t::regional_indicator_y: - :flag_de: :rainbow_flag: - :face_with_bags_under_eyes: :splatter: :root_vegetable: - :distorted_face: :fight_cloud: :hairy_creature: Supports discord custom emoji - <:meowblob:1245470561296187504> - `<:meowblob:1245470561296187504>` - <:catsmile:1271230456188375111>Love<:catsmile:1271230456188375111>:heart: - `<:catsmile:1271230456188375111>Love<:catsmile:1271230456188375111>:heart:` - webp-only animated emoji - `` ### Task Lists * [ ] Unchecked task * [x] Checked task Checked task Checked task Checked task Checked task Checked task Checked task Checked task Checked task Checked task Checked task Checked task Checked task Checked task Checked task Checked task Checked task Checked task Checked task Checked task Checked task Checked task Checked task Checked task Checked task Checked task Checked task Checked task Checked task Checked task Checked task Checked task Checked task * [ ] Another unchecked task ## Links * [Inline link](https://www.example.com) * [Link with title](https://www.example.com "Example.com") * (Autolink) Voidcannon can also resolve content ID based links to their respective slugs: ```md [Playground Article](./[playground] "Example") ``` * [Playground Article](./[playground] "Example") ## Images The custom `` element can be used to render full-width sections. Images will automatically stretch to fill the available width. ![Cat using computer](assets/Cat_using_computer.jpg "look at this cat") ![Alt text](https://www.google.com/images/branding/googlelogo/2x/googlelogo_color_272x92dp.png "Google Logo") ![Alt text](media/menu.jpg) ## Code ### Inline Code * `print("Hello, world!")` ### Code Blocks ```python def greet(name): print(f"Hello, {name}!") greet("World") ``` This codeblock is expandable to save on space. ```javascript import { VoidcannonContentType, VoidcannonSectionType } from "voidcannon"; import {PagexResourceTransformer} from "pagex"; import CollectionContentTransformer from "voidcannon/src/transformers/CollectionContent.transformer.js"; export default { type: VoidcannonContentType.EDITORIAL, id: "index", name: "Voidcannon Home", description: "Voidcannon Home", color: null, sections: [ { type: VoidcannonSectionType.CAROUSEL, content: { _transform: CollectionContentTransformer.id, collection_id: "featured" }, label: "Featured Articles", target: "collections/featured" }, { type: VoidcannonSectionType.EDITORIAL, content: { _transform: PagexResourceTransformer.MARKDOWN, path: "./content.md" } }, { type: VoidcannonSectionType.CONTENT_GRID, content: { _transform: CollectionContentTransformer.id, collection_id: "recent" }, label: "Recent Articles" } ] } ``` ```javascript function sayHello(name) { console.log("Hello, " + name + "!"); } sayHello("World"); function foo(name) { console.log("Hello, " + name + "!"); } foo("bar"); ``` ``` No language specified This is a plain code block. ``` ### Advanced Formatting ```javascript // Additions and Removals Helo// [!code --] Helo// [!code --] Helo// [!code --] Hello// [!code ++] Hello// [!code ++] Hello// [!code ++] // Errors and Warnings guh() pluh()// [!code warning] pluhey()// [!code error] // Highlighting // [!code highlight:5] dong.expand(); // This is a large highlighted section const a = "b"; console.log("a" + a); function b(c) {return d;} ``` ```diff diff --git a/pages/resources/integration.mdx b/pages/resources/integration.mdx index 21d48f59..49445b53 100644 --- a/pages/resources/integration.mdx +++ b/pages/resources/integration.mdx @@ -110,19 +110,22 @@ Integrations represent a connection between a service and a guild. This may incl ###### GIF Media Format -| Value | Description | -| --------- | ------------------------------------ | -| mp4 | MP4 video | -| tinymp4 | MP4 video in a smaller size | -| nanomp4 | MP4 video in a very small size | -| loopedmp4 | MP4 video that loops (same as `mp4`) | -| webm | WebM video | -| tinywebm | WebM video in a smaller size | -| nanowebm | WebM video in a very small size | -| gif | GIF image | -| mediumgif | GIF image in a medium size | -| tinygif | GIF image in a smaller size | -| nanogif | GIF image in a very small size | +| Value | Description | Description | Description | +| --------- | ---------------------------------------- | ---------------------------------------- | ---------------------------------------- | +| mp4 | MP4 video | MP4 video | MP4 video | +| tinymp4 | MP4 video in a smaller size | MP4 video in a smaller size | MP4 video in a smaller size | +| nanomp4 | MP4 video in a very small size | MP4 video in a very small size | MP4 video in a very small size | +| loopedmp4 | MP4 video that loops (same as `mp4`) | MP4 video that loops (same as `mp4`) | MP4 video that loops (same as `mp4`) | +| webm | WebM video | WebM video | WebM video | +| tinywebm | WebM video in a smaller size | WebM video in a smaller size | WebM video in a smaller size | +| nanowebm | WebM video in a very small size | WebM video in a very small size | WebM video in a very small size | +| gif | GIF image | GIF image | GIF image | +| mediumgif | GIF image in a medium size | GIF image in a medium size | GIF image in a medium size | +| tinygif | GIF image in a smaller size | GIF image in a smaller size | GIF image in a smaller size | +| nanogif | GIF image in a very small size | GIF image in a very small size | GIF image in a very small size | +| webp | Animated WebP image | Animated WebP image | Animated WebP image | +| tinywebp | Animated WebP image in a smaller size | Animated WebP image in a smaller size | Animated WebP image in a smaller size | +| nanowebp | Animated WebP image in a very small size | Animated WebP image in a very small size | Animated WebP image in a very small size | ###### Example GIF @@ -337,15 +340,17 @@ Returns a list of [GIF](#gif-structure) objects based on the provided query. ###### Query String Parameters -| Field | Type | Description | -| ------------- | ------- | ----------------------------------------------------- | -| q | string | The search query to use | -| limit? ^1^ | integer | The maximum number of GIFs to return (20-500) | -| media_format? | string | The media format to use (default `mediumgif`) | -| locale? | string | The locale to use in search results (default `en-US`) | +| Field | Type | Description | +| ---------------- | ------- | ----------------------------------------------------------- | +| q | string | The search query to use | +| limit? ^1^ | integer | The maximum number of GIFs to return (20-500) (default 100) | +| media_format ^2^ | string | The [media format](#gif-media-format) to use | +| locale? | string | The locale to use in search results (default `en-US`) | ^1^ The limit is only a suggestion; the API may return fewer GIFs. +^2^ Invalid values default to `gif`. + Get Trending GIF Categories @@ -354,10 +359,10 @@ Returns trending GIF categories and their associated preview GIFs. ###### Query String Parameters -| Field | Type | Description | -| ------------- | ------ | ----------------------------------------------------- | -| media_format? | string | The media format to use (default `mediumgif`) | -| locale? | string | The locale to use in search results (default `en-US`) | +| Field | Type | Description | +| ------------ | ------ | ----------------------------------------------------- | +| media_format | string | The [media format](#gif-media-format) to use | +| locale? | string | The locale to use in search results (default `en-US`) | ###### Response Body @@ -406,11 +411,11 @@ Returns a list of [GIF](#gif-structure) objects that are currently trending. ###### Query String Parameters -| Field | Type | Description | -| ------------- | ------- | ----------------------------------------------------- | -| limit? ^1^ | integer | The maximum number of GIFs to return (20-500) | -| media_format? | string | The media format to use (default `mediumgif`) | -| locale? | string | The locale to use in search results (default `en-US`) | +| Field | Type | Description | +| ------------ | ------- | ----------------------------------------------------- | +| limit? ^1^ | integer | The maximum number of GIFs to return (20-500) | +| media_format | string | The [media format](#gif-media-format) to use | +| locale? | string | The locale to use in search results (default `en-US`) | ^1^ The limit is only a suggestion; the API may return fewer GIFs. ``` ```protobuf syntax = "proto3"; package bignutty.pagex; // Represents preprocessed metadata for pagex media items. message PagexProcessedMedia { // The version of this metadata payload. int32 version = 1; // Preprocessed LQIP value for this media item. int32 lqip = 2; // Attributions repeated PagexMediaAttribution attributions = 3; } // An attribution (copyright, source) for a media item. message PagexMediaAttribution { // Text label (i.e Copyright 2025 bignutty). string label = 1; // URL linking to the original source or author. optional string url = 2; } ``` ```protobuf syntax = 'proto3'; package fm.last.api; import "bignutty/api/JsField.proto"; import "fm/last/api/common.proto"; // Last.fm `track` service. service TrackService { // track.getInfo // Returns information about a track. rpc getInfo(TrackInfoRequest) returns (TrackInfoResponse); } // Query parameters for a track.getInfo request. message TrackInfoRequest { // Track name (required, unless mbid is provided). optional string track = 1; // Artist name (required, unless mbid is provided). optional string artist = 2; // MusicBrainz Recording ID. optional string mbid = 3; // User to retrieve stats for optional string username = 4; // Autocorrect tracks via corrections. optional bool autocorrect = 5; } // A track as returned by the track.getInfo method. message TrackInfoResponse { // An artist fragment in track.getInfo responses. message PartialArtist { // Canonical name of the artist. string name = 1; // Last.fm URL for the artist. string url = 2; // MusicBrainz ID for the artist. optional string mbid = 3; } // An album fragment in track.getInfo responses. message PartialAlbum { // Canonical title of the album. string title = 1; // Canonical name of the album artist. string artist = 2; // Last.fm URL for the album. string url = 3; // Cover artwork for the album. repeated fm.last.api.Image image = 4; } // Metadata about Last.fm site streaming. message StreamingMetadata { // Whether the track can be streamed. bool streamable = 1 [(bignutty.api.js_field) = "#text"]; // Whether the full track is available for streaming. bool fulltrack = 2; } // Top Tags fragment in track.getInfo responses. message TopTags { // Tag fragment. message PartialTag { // Tag Name string name = 1; // Last.fm URL for the tag. string url = 2; } // List of top tags. (max. 5) repeated PartialTag tag = 1; } // Canonical name of the track. string name = 1; // Last.fm URL. string url = 2; // Duration of the track. // Will be "0" when the duration is unknown. int32 duration = 3; // Global listener count. int32 listeners = 4; // Global scrobble count. int32 playcount = 5; // Amount of scrobbles the user has for this track. optional int32 userplaycount = 6 [(fm.last.api.requires_user)=true]; // Whether the user has loved the track. optional bool userloved = 7 [(fm.last.api.requires_user)=true]; // Artist associated with the track. PartialArtist artist = 10; // Canonical album this track is featured on. optional PartialAlbum album = 11; // If the track can be streamed on last.fm. StreamingMetadata streamable = 20 [deprecated=true]; // Top tags added by users. TopTags toptags = 21; // Wiki entry written by users. optional fm.last.api.Wiki wiki = 22; } ``` ## Horizontal Rule --- ## Blockquotes > This is a blockquote. > It can span multiple lines. > > And even be nested. ## Tables | Header 1 | Header 2 | Header 3 | Header 3 | Header 3 | Header 3 | Header 3 | Header 3 | Header 3 | Header 3 | Header 3 | Header 3 | Header 3 | Header 3 | Header 3 | | -------- | -------- | -------- | -------- | -------- | -------- | -------- | -------- | -------- | -------- | -------- | -------- | -------- | -------- | -------- | | Cell 1 | Cell 2 | Cell 3 | Cell 3 | Cell 3 | Cell 3 | Cell 3 | Cell 3 | Cell 3 | Cell 3 | Cell 3 | Cell 3 | Cell 3 | Cell 3 | Cell 3 | | Cell 4 | Cell 5 | Cell 6 | Cell 6 | Cell 6 | Cell 6 | Cell 6 | Cell 6 | Cell 6 | Cell 6 | Cell 6 | Cell 6 | Cell 6 | Cell 6 | Cell 6 | | Field | Type | Description | |-------------------------------|----------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------| | id | snowflake | The ID of the message | | channel_id | snowflake | The ID of the channel the message was sent in | | lobby_id? | snowflake | The ID of the lobby the message was sent in | | author ^1^ | partial [user](/resources/user#user-object) object | The author of the message | | content ^2^ | string | Contents of the message | | timestamp | ISO8601 timestamp | When this message was sent | | edited_timestamp | ?ISO8601 timestamp | When this message was last edited | | tts | boolean | Whether this message will be read out by TTS | | mention_everyone | boolean | Whether this message mentions everyone | | mentions | array[partial [user](/resources/user#user-object) object] | Users specifically mentioned in the message | | mention_roles | array[snowflake] | Roles specifically mentioned in this message | | mention_channels? ^3^ | array[partial [channel](/resources/channel#channel-object) object] | Channels specifically mentioned in this message | | attachments ^2^ | array[[attachment](#attachment-object) object] | The attached files | | embeds ^2^ | array[[embed](#embed-object) object] | Content embedded in the message | | reactions? | array[[reaction](#reaction-object) object] | Reactions on the message | | nonce? | integer \| string | The message's nonce, used for message deduplication | | pinned | boolean | Whether this message is pinned | | webhook_id? | snowflake | The ID of the webhook that send the message | | type | integer | The [type of message](#message-type) | | activity? | [message activity](#message-activity-object) object | The rich presence activity the author is inviting users to | | application? | [integration application](/resources/integration#integration-application-object) object | The application of the message's rich presence activity | | application_id? | snowflake | The ID of the application; only sent for interaction responses and messages created through OAuth2 | | flags | integer | The [message's flags](#message-flags) | | message_reference? ^4^ | [message reference](#message-reference-object) object | The source of a crosspost, snapshot, channel follow add, pin, or reply message | | referenced_message? ^5^ ^4^ | ?[message object](#message-object) | The message associated with the `message_reference` | | message_snapshots? ^4^ | array[[message snapshot](#message-snapshot-object) object] | The partial message snapshot associated with the `message_reference` | | call? | [message call](#message-call-object) object | The private channel call that prompted this message | | interaction? **(deprecated)** | [message interaction](/interactions/receiving-and-responding#message-interaction-structure) object | The interaction the message is responding to | | interaction_metadata? | [message interaction metadata](#message-interaction-metadata-object) object | The interaction the message originated from | | resolved? | [resolved data](/interactions/receiving-and-responding#resolved-data-structure) object | Data for users, members, channels, and roles referenced in this message | | thread? | [channel](/resources/channel#channel-object) object | The thread that was started from this message, with the [`member`](/resources/channel#channel-object) key representing thread member data | | role_subscription_data? | [message role subscription](#message-role-subscription-object) object | The role subscription purchase or renewal that prompted this message | | purchase_notification? | [message purchase notification](#message-purchase-notification-object) object | The guild purchase that prompted this message | | gift_info? | [message gift info](#message-gift-info-object) object | Information on the gift that prompted this message | | components ^2^ | array[[message component](/resources/components#component-object) object] | The message's components (e.g. buttons, select menus) | | sticker_items? | array[[sticker item](/resources/sticker#sticker-item-object) object] | The message's sticker items | | stickers? | array[[sticker](/resources/sticker#sticker-object) object] | Extra rich information for the message's sticker items; only available in some contexts | | poll? ^2^ | [poll](#poll-object) object | A poll! | | changelog_id? | snowflake | The ID of the changelog that prompted this message | | soundboard_sounds? | array[[soundboard sound](/resources/soundboard/#soundboard-sound-object) object] | The message's soundboard sounds | | potions? | array[[potion](#potion-object) object] | Potions applied to the message | | shared_client_theme? | [shared client theme](#shared-client-theme-object) object | The shared client theme | ## HTML

This is some HTML text.

Test convert_to_text this is a cta rendered from a markdown document
## Line Breaks This is a line.
This is another line. ## Escaping \* \* \* \* \* ## Special Characters ` ~ ! @ # $ % ^ & * ( ) - _ = + [ ] { } | ; : ' " , . / < > ?