Merge branch 'main' of https://github.com/raspdevpy/ccdoc into main

Author: NervN

guide/.vuepress/public/fonts/Assistant-Medium.ttf

@@ -0,0 +1,34 @@
+@font-face {
+    font-family: 'Assistant-Medium';
+    src: url('/fonts/Assistant-Medium.ttf') format('truetype');
+    font-style: normal;
+    font-weight: normal;
+}
+@font-face {
+    font-family: 'Noto-Sans-Medium';
+    src: url('/fonts/NotoSans-Medium.ttf') format('truetype');
+    font-style: normal;
+    font-weight: normal;
+}
+.discord-messages {
+    background-color: #202024 !important;
+    border: 1px solid #3f4245 !important;
+}
+.discord-messages,
+.discord-messages * {
+    font-family: 'Assistant-Medium', sans-serif !important;
+}
+.discord-message .discord-author-info .discord-author-username {
+    font-family: 'Noto-Sans-Medium', sans-serif !important;
+    font-size: 0.95rem !important;
+    letter-spacing: 0px !important;
+    display: inline-flex !important;
+}
+.discord-message .discord-message-body {
+    font-size: 15px !important;
+}
+.discord-message .discord-message-content .discord-message-timestamp {
+    display: inline-flex !important;
+    font-size: 11px !important;
+    margin-left: 5px !important;
+}

guide/.vuepress/public/fonts/NotoSans-Medium.ttf

@@ -1,81 +1,44 @@
 # $authorAvatar
 
-Returns the URL to the User's avatar that triggered the command.
-
-::: tip Discord adds image to message if link provided  <Badge type="tip" text="Read examples section" vertical="middle"/>
-If a message contains only a link to an image, Discord sends **only** the image.
-
-If a message has a link to an image AND some text, Discord sends **both** the link and the image.
-
-To add image without posting the link use [$attachment](../Text/Embed/attachment.md)
-
-To send link as a plain text wrap the function into graves like<code>\`$authorAvatar\`</code>
-:::
+Returns the avatar (profile picture) URL of the user who executed the command.
 
 ## Usage
 
 ```bash
-$authorAvatar[Return Server Avatar Instead (yes/no, default is no)]
+$authorAvatar[serverAvatar]
 ```
+1. **serverAvatar** - (Optional) default value: `no`. Can be `yes` or `no`. Discord does have two types of avatars, global and per-server (custom avatar in each server). If no server avatar is set, the global avatar will be used.
 
 ## Examples
 
-### Message contains text and link to image
+#### Sending avatar URL
 
-<discord-messages>
-	<discord-message :bot="false" role-color="#ffcc9a" author="crochet" avatar="https://cdn.discordapp.com/avatars/808007806266769458/768de61c5d90024e100ec5c058d3c2fe.webp?size=4096" >
-		!!exec My avatar link: $authorAvatar<br/>
-        Image attached below:
-	</discord-message>
-	<discord-message :bot="true" role-color="#0099ff" author="Custom Command" avatar="https://media.discordapp.net/avatars/725721249652670555/781224f90c3b841ba5b40678e032f74a.webp" >
-        My avatar link:
-            <a href="https://cdn.discordapp.com/avatars/808007806266769458/768de61c5d90024e100ec5c058d3c2fe.webp?size=4096">
-                https://cdn.discordapp.com/avatars/808007806266769458/768de61c5d90024e100ec5c058d3c2fe.webp?size=4096
-            </a><br/>
-        Image attached below:
-        <DiscordReaction image="https://cdn.discordapp.com/avatars/808007806266769458/768de61c5d90024e100ec5c058d3c2fe.webp?size=4096"></DiscordReaction>
-    </discord-message>
-</discord-messages>
-
-### Message contains only link to image
+How is the avatar URL displayed when sent with text and without text
 
-::: details Example
 <discord-messages>
-    <discord-message :bot="false" role-color="#ffcc9a" author="crochet" avatar="https://cdn.discordapp.com/avatars/808007806266769458/768de61c5d90024e100ec5c058d3c2fe.webp?size=4096" >
-        !!exec $authorAvatar
+    <discord-message :bot="false" role-color="#d6e0ff" author="User" avatar="https://cdn.discordapp.com/embed/avatars/0.png">
+        !!exec With text: $authorAvatar
     </discord-message>
-    <discord-message :bot="true" role-color="#0099ff" author="Custom Command" avatar="https://media.discordapp.net/avatars/725721249652670555/781224f90c3b841ba5b40678e032f74a.webp" >
-        <DiscordReaction image="https://cdn.discordapp.com/avatars/808007806266769458/768de61c5d90024e100ec5c058d3c2fe.webp?size=4096"></DiscordReaction>
+    <discord-message :bot="true" role-color="#5fb0fa" author="Custom Command" avatar="https://doc.ccommandbot.com/bot-profile.png">
+        With text: <a href="https://cdn.discordapp.com/embed/avatars/0.png">
+        https://cdn.discordapp.com/embed/avatars/0.png
+        </a><br>
+        <img src="https://cdn.discordapp.com/embed/avatars/0.png" alt="User Avatar" style="vertical-align: text-bottom;" />
     </discord-message>
-</discord-messages>
-:::
-
-### Send text and image without link
-
-::: details Example
-<discord-messages>
-    <discord-message :bot="false" role-color="#ffcc9a" author="crochet" avatar="https://cdn.discordapp.com/avatars/808007806266769458/768de61c5d90024e100ec5c058d3c2fe.webp?size=4096" >
-        !!exec No link, only text and image<br/>
-        $attachment[$authorAvatar]
+    <discord-message :bot="false" role-color="#d6e0ff" author="User" avatar="https://cdn.discordapp.com/embed/avatars/0.png">
+        !!exec $authorAvatar
     </discord-message>
-    <discord-message :bot="true" role-color="#0099ff" author="Custom Command" avatar="https://media.discordapp.net/avatars/725721249652670555/781224f90c3b841ba5b40678e032f74a.webp" >
-        No link, only text and image
-        <DiscordReaction image="https://cdn.discordapp.com/avatars/808007806266769458/768de61c5d90024e100ec5c058d3c2fe.webp?size=4096"></DiscordReaction>
+    <discord-message :bot="true" role-color="#5fb0fa" author="Custom Command" avatar="https://doc.ccommandbot.com/bot-profile.png">
+        <img src="https://cdn.discordapp.com/embed/avatars/0.png" alt="User Avatar" style="vertical-align: text-bottom;" />
     </discord-message>
 </discord-messages>
+
+::: tip Note
+You can send the image as an attachment, so no link will be displayed. For this, you can use function [$attachment](../Text/Embed/attachment.md).
+To display the avatar URL as plain text, either enclose the function in backticks (`` `$authorAvatar` ``) or angle brackets (`<$authorAvatar>`).
 :::
 
-### Send link as plain text
+##### Related functions: [$attachment](../Text/Embed/attachment.md)
 
-::: details Example
-<discord-messages>
-    <discord-message :bot="false" role-color="#ffcc9a" author="crochet" avatar="https://cdn.discordapp.com/avatars/808007806266769458/768de61c5d90024e100ec5c058d3c2fe.webp?size=4096" >
-        !!exec <DiscordMarkdown>`$authorAvatar`</DiscordMarkdown><br/>
-    </discord-message>
-    <discord-message :bot="true" role-color="#0099ff" author="Custom Command" avatar="https://media.discordapp.net/avatars/725721249652670555/781224f90c3b841ba5b40678e032f74a.webp" >
-        <DiscordMarkdown>
-            `https://cdn.discordapp.com/avatars/808007806266769458/768de61c5d90024e100ec5c058d3c2fe.webp?size=4096`
-        </DiscordMarkdown>
-    </discord-message>
-</discord-messages>
-:::
+##### Function difficulty: <Badge type="tip" text="Easy" vertical="middle"/>
+###### Tags: <Badge type="tip" text="Image" vertical="middle"/> <Badge type="tip" text="Avatar" vertical="middle"/> <Badge type="tip" text="Attachment" vertical="middle"/> <Badge type="tip" text="profile picture" vertical="middle"/>

guide/.vuepress/styles/index.scss

@@ -1,93 +1,44 @@
 # $authorAvatar
 
-This function returns the URL of the avatar for the user who triggered the command.
-
-::: tip Important Considerations
-Discord automatically embeds images when a link to an image is included in a message.  See the examples below to understand the different ways Discord handles image links.
-- If a message contains *only* a link to an image, Discord sends only the image embed.
-- If a message contains a link to an image *and* additional text, Discord sends both the link and the image embed.
-
-To send the image as an attachment *without* displaying the link, use the [$attachment](../Text/Embed/attachment.md) function.
-
-To display the avatar URL as plain text (without embedding the image), enclose the function in backticks:  `` `$authorAvatar` ``.
-:::
+Returns the avatar (profile picture) URL of the user who executed the command.
 
 ## Usage
 
 ```bash
-$authorAvatar[Return Server Avatar Instead (yes/no, default is no)]
+$authorAvatar[serverAvatar]
 ```
-
-## Arguments
-
-*   `Return Server Avatar Instead (yes/no, default is no)`:  An optional argument.  If set to `yes`, the function will return the user's server avatar (if they have one) instead of their global avatar.  Defaults to `no`.
+1. **serverAvatar** - (Optional) default value: `no`. Can be `yes` or `no`. Discord does have two types of avatars, global and per-server (custom avatar in each server). If no server avatar is set, the global avatar will be used.
 
 ## Examples
 
-### Sending the Avatar URL with Text
+#### Sending avatar URL
 
-This example demonstrates how the avatar URL is displayed when sent with accompanying text.
+How is the avatar URL displayed when sent with text and without text
 
 <discord-messages>
-	<discord-message :bot="false" role-color="#ffcc9a" author="crochet" avatar="https://cdn.discordapp.com/avatars/808007806266769458/768de61c5d90024e100ec5c058d3c2fe.webp?size=4096" >
-		!!exec My avatar link: $authorAvatar<br/>
-        Image attached below:
-	</discord-message>
-	<discord-message :bot="true" role-color="#0099ff" author="Custom Command" avatar="https://media.discordapp.net/avatars/725721249652670555/781224f90c3b841ba5b40678e032f74a.webp" >
-        My avatar link:
-            <a href="https://cdn.discordapp.com/avatars/808007806266769458/768de61c5d90024e100ec5c058d3c2fe.webp?size=4096">
-                https://cdn.discordapp.com/avatars/808007806266769458/768de61c5d90024e100ec5c058d3c2fe.webp?size=4096
-            </a><br/>
-        Image attached below:
-        <DiscordReaction image="https://cdn.discordapp.com/avatars/808007806266769458/768de61c5d90024e100ec5c058d3c2fe.webp?size=4096"></DiscordReaction>
+    <discord-message :bot="false" role-color="#d6e0ff" author="User" avatar="https://cdn.discordapp.com/embed/avatars/0.png">
+        !!exec With text: $authorAvatar
     </discord-message>
-</discord-messages>
-
-### Sending Only the Avatar URL
-
-This example demonstrates how the avatar is embedded when *only* the avatar URL is sent in the message.
-
-::: details Example
-<discord-messages>
-    <discord-message :bot="false" role-color="#ffcc9a" author="crochet" avatar="https://cdn.discordapp.com/avatars/808007806266769458/768de61c5d90024e100ec5c058d3c2fe.webp?size=4096" >
+    <discord-message :bot="true" role-color="#5fb0fa" author="Custom Command" avatar="https://doc.ccommandbot.com/bot-profile.png">
+        With text: <a href="https://cdn.discordapp.com/embed/avatars/0.png">
+        https://cdn.discordapp.com/embed/avatars/0.png
+        </a><br>
+        <img src="https://cdn.discordapp.com/embed/avatars/0.png" alt="User Avatar" style="vertical-align: text-bottom;" />
+    </discord-message>
+    <discord-message :bot="false" role-color="#d6e0ff" author="User" avatar="https://cdn.discordapp.com/embed/avatars/0.png">
         !!exec $authorAvatar
     </discord-message>
-    <discord-message :bot="true" role-color="#0099ff" author="Custom Command" avatar="https://media.discordapp.net/avatars/725721249652670555/781224f90c3b841ba5b40678e032f74a.webp" >
-        <DiscordReaction image="https://cdn.discordapp.com/avatars/808007806266769458/768de61c5d90024e100ec5c058d3c2fe.webp?size=4096"></DiscordReaction>
+    <discord-message :bot="true" role-color="#5fb0fa" author="Custom Command" avatar="https://doc.ccommandbot.com/bot-profile.png">
+        <img src="https://cdn.discordapp.com/embed/avatars/0.png" alt="User Avatar" style="vertical-align: text-bottom;" />
     </discord-message>
 </discord-messages>
-:::
-
-### Sending the Avatar as an Attachment (Without the Link)
-
-This example demonstrates how to send the avatar as an attachment *without* including the direct link in the message.  This is achieved using the `$attachment` function.
 
-::: details Example
-<discord-messages>
-    <discord-message :bot="false" role-color="#ffcc9a" author="crochet" avatar="https://cdn.discordapp.com/avatars/808007806266769458/768de61c5d90024e100ec5c058d3c2fe.webp?size=4096" >
-        !!exec No link, only text and image<br/>
-        $attachment[$authorAvatar]
-    </discord-message>
-    <discord-message :bot="true" role-color="#0099ff" author="Custom Command" avatar="https://media.discordapp.net/avatars/725721249652670555/781224f90c3b841ba5b40678e032f74a.webp" >
-        No link, only text and image
-        <DiscordReaction image="https://cdn.discordapp.com/avatars/808007806266769458/768de61c5d90024e100ec5c058d3c2fe.webp?size=4096"></DiscordReaction>
-    </discord-message>
-</discord-messages>
+::: tip Note
+You can send the image as an attachment, so no link will be displayed. For this, you can use function [$attachment](../Text/Embed/attachment.md).
+To display the avatar URL as plain text, either enclose the function in backticks (`` `$authorAvatar` ``) or angle brackets (`<$authorAvatar>`).
 :::
 
-### Sending the Avatar URL as Plain Text
-
-This example demonstrates how to display the avatar URL as plain text instead of embedding the image.  This is done by wrapping the function call in backticks.
+##### Related functions: [$attachment](../Text/Embed/attachment.md)
 
-::: details Example
-<discord-messages>
-    <discord-message :bot="false" role-color="#ffcc9a" author="crochet" avatar="https://cdn.discordapp.com/avatars/808007806266769458/768de61c5d90024e100ec5c058d3c2fe.webp?size=4096" >
-        !!exec <DiscordMarkdown>`$authorAvatar`</DiscordMarkdown><br/>
-    </discord-message>
-    <discord-message :bot="true" role-color="#0099ff" author="Custom Command" avatar="https://media.discordapp.net/avatars/725721249652670555/781224f90c3b841ba5b40678e032f74a.webp" >
-        <DiscordMarkdown>
-            `https://cdn.discordapp.com/avatars/808007806266769458/768de61c5d90024e100ec5c058d3c2fe.webp?size=4096`
-        </DiscordMarkdown>
-    </discord-message>
-</discord-messages>
-:::
+##### Function difficulty: <Badge type="tip" text="Easy" vertical="middle"/>
+###### Tags: <Badge type="tip" text="Image" vertical="middle"/> <Badge type="tip" text="Avatar" vertical="middle"/> <Badge type="tip" text="Attachment" vertical="middle"/> <Badge type="tip" text="profile picture" vertical="middle"/>

guide/Member/authorAvatar.md

@@ -1,20 +1,29 @@
 # $authorID
-Returns the ID of the User that triggered the command.
 
-#### Usage: `$authorID`
-<br/>
+Returns the ID of the user who executed the command.
+
+## Usage
+
+```bash
+$authorID
+```
+
+## Example
+
+#### Using $authorID
+
+How to use $authorID
+
 <discord-messages>
-	<discord-message :bot="false" role-color="#ffcc9a" author="User">
-		!!exec $authorID
-	</discord-message>
-	<discord-message :bot="true" role-color="#0099ff" author="Custom Command" avatar="https://media.discordapp.net/avatars/725721249652670555/781224f90c3b841ba5b40678e032f74a.webp">
-		683630053686378498
-	</discord-message>
+    <discord-message :bot="false" role-color="#d6e0ff" author="User" avatar="https://cdn.discordapp.com/embed/avatars/0.png">
+        !!exec My ID is $authorID
+    </discord-message>
+    <discord-message :bot="true" role-color="#5fb0fa" author="Custom Command" avatar="https://doc.ccommandbot.com/bot-profile.png">
+        My ID is 123456789123456789
+    </discord-message>
 </discord-messages>
 
-::: tip Related Functions
-[$mention](../Member/mention.md) ― to mention the author of a command!
-:::
+##### Related functions: [$mention](../Member/mention.md)
 
-##### Function difficulty: <Badge type="tip" text="Easy" vertical="middle" /> 
-###### Tags: <Badge type="tip" text="authorID" vertical="middle" /> <Badge type="tip" text="cmd executor" vertical="middle" /> <Badge type="tip" text="command author" vertical="middle" /> <Badge type="tip" text="command" vertical="middle" /> <Badge type="tip" text="userID" vertical="middle" />
+##### Function Difficulty: <Badge type="tip" text="Easy" vertical="middle" />
+###### Tags: <Badge type="tip" text="authorID" vertical="middle" /> <Badge type="tip" text="executor" vertical="middle" /> <Badge type="tip" text="command author" vertical="middle" /> <Badge type="tip" text="" vertical="middle" /> <Badge type="tip" text="userID" vertical="middle" />

guide/Member/authorAvatar_ai.md

@@ -1,28 +1,29 @@
 # $authorID
 
-This function retrieves the unique ID of the user who executed the command. This ID can be used in other functions or for logging purposes.
+Returns the ID of the user who executed the command.
 
-#### Usage: `$authorID`
+## Usage
 
-<br/>
+```bash
+$authorID
+```
 
-Here's an example of how `$authorID` works:
+## Example
+
+#### Using $authorID
+
+How to use $authorID
 
 <discord-messages>
-  <discord-message :bot="false" role-color="#ffcc9a" author="User">
-    !!exec $authorID
-  </discord-message>
-  <discord-message :bot="true" role-color="#0099ff" author="Custom Command" avatar="https://media.discordapp.net/avatars/725721249652670555/781224f90c3b841ba5b40678e032f74a.webp">
-    683630053686378498
-  </discord-message>
+    <discord-message :bot="false" role-color="#d6e0ff" author="User" avatar="https://cdn.discordapp.com/embed/avatars/0.png">
+        !!exec My ID is $authorID
+    </discord-message>
+    <discord-message :bot="true" role-color="#5fb0fa" author="Custom Command" avatar="https://doc.ccommandbot.com/bot-profile.png">
+        My ID is 123456789123456789
+    </discord-message>
 </discord-messages>
 
-In this example, the user executed the command `!!exec $authorID`.  The custom command then returned the user's ID: `683630053686378498`.
-
-::: tip Related Functions
-[$mention](../Member/mention.md) ― Use this function to mention the author of a command within a message!
-:::
+##### Related functions: [$mention](../Member/mention.md)
 
 ##### Function Difficulty: <Badge type="tip" text="Easy" vertical="middle" />
-
-###### Tags: <Badge type="tip" text="authorID" vertical="middle" /> <Badge type="tip" text="cmd executor" vertical="middle" /> <Badge type="tip" text="command author" vertical="middle" /> <Badge type="tip" text="command" vertical="middle" /> <Badge type="tip" text="userID" vertical="middle" />
+###### Tags: <Badge type="tip" text="authorID" vertical="middle" /> <Badge type="tip" text="executor" vertical="middle" /> <Badge type="tip" text="command author" vertical="middle" /> <Badge type="tip" text="" vertical="middle" /> <Badge type="tip" text="userID" vertical="middle" />