Updated documentation

This commit is contained in:
Daniil Gentili 2016-10-25 00:19:54 +02:00 committed by GitHub
parent ee9ea8fecb
commit d1a6532879
3 changed files with 55 additions and 33 deletions

View File

@ -51,7 +51,7 @@ contact, because some users has similar usernames to <code>botfather</code>.</p>
call it? Please choose a name for your bot.</code></p></li> call it? Please choose a name for your bot.</code></p></li>
<li><p>Type whatever name you want for your bot.</p></li> <li><p>Type whatever name you want for your bot.</p></li>
<li><p><a href="https://github.com/botfather" class="user-mention">@botfather</a> replies with <code>Good. Now let's choose a username for your <li><p><a href="https://github.com/botfather" class="user-mention">@botfather</a> replies with <code>Good. Now let's choose a username for your
bot. It must end in</code>bot<code>. Like this, for example: TetrisBot or bot. It must end in bot. Like this, for example: TetrisBot or
tetris_bot.</code></p></li> tetris_bot.</code></p></li>
<li><p>Type whatever username you want for your bot, minimum 5 characters, <li><p>Type whatever username you want for your bot, minimum 5 characters,
and must end with <code>bot</code>. For example: <code>telesample_bot</code></p></li> and must end with <code>bot</code>. For example: <code>telesample_bot</code></p></li>
@ -111,6 +111,8 @@ Then start editing the commands.</p>
<li> <li>
<code>$MESSAGE</code>: Incoming messages</li> <code>$MESSAGE</code>: Incoming messages</li>
<li> <li>
<code>$MESSAGE[ID]</code>: ID of incoming message</li>
<li>
<code>$CAPTION</code>: Captions</li> <code>$CAPTION</code>: Captions</li>
<li> <li>
<code>$USER</code>: This array contains the First name, last name, username and user id of the sender of the current message. <code>$USER</code>: This array contains the First name, last name, username and user id of the sender of the current message.
@ -127,6 +129,26 @@ Then start editing the commands.</p>
</ul> </ul>
</li> </li>
<li> <li>
<code>$CHAT</code>: This array contains the First name, last name, username, title and user id of the chat of the current message.
<ul>
<li>
<code>${CHAT[ID]}</code>: Chat id</li>
<li>
<code>${CHAT[FIRST_NAME]}</code>: Chat's first name</li>
<li>
<code>${CHAT[LAST_NAME]}</code>: Chat's last name</li>
<li>
<code>${CHAT[USERNAME]}</code>: Username</li>
<li>
<code>${CHAT[TITLE]}</code>: Title</li>
<li>
<code>${CHAT[TYPE]}</code>: Type</li>
<li>
<code>${CHAT[ALL_MEMBERS_ARE_ADMINISTRATORS]}</code>: All members are administrators (true if true)</li>
</ul>
</li>
<li>
<code>$URLS</code>: This array contains documents, audio files, stickers, voice recordings and stickers stored in the form of URLs. <code>$URLS</code>: This array contains documents, audio files, stickers, voice recordings and stickers stored in the form of URLs.
<ul> <ul>
@ -175,51 +197,51 @@ Then start editing the commands.</p>
<p>To send messages use the <code>send_message</code> function:</p> <p>To send messages use the <code>send_message</code> function:</p>
<pre><code>send_message "${USER[ID]}" "lol" <pre><code>send_message "${CHAT[ID]}" "lol"
</code></pre> </code></pre>
<p>To send html or markdown put the following strings before the text, depending on the parsing mode you want to enable:</p> <p>To send html or markdown put the following strings before the text, depending on the parsing mode you want to enable:</p>
<pre><code>send_message "${USER[ID]}" "markdown_parse_mode lol *bold*" <pre><code>send_message "${CHAT[ID]}" "markdown_parse_mode lol *bold*"
</code></pre> </code></pre>
<pre><code>send_message "${USER[ID]}" "html_parse_mode lol &lt;b&gt;bold&lt;/b&gt;" <pre><code>send_message "${CHAT[ID]}" "html_parse_mode lol &lt;b&gt;bold&lt;/b&gt;"
</code></pre> </code></pre>
<p>This function also allows a third parameter that disables additional function parsing (for safety use this when reprinting user input):</p> <p>This function also allows a third parameter that disables additional function parsing (for safety use this when reprinting user input):</p>
<pre><code>send_message "${USER[ID]}" "lol" "safe" <pre><code>send_message "${CHAT[ID]}" "lol" "safe"
</code></pre> </code></pre>
<p>To send images, videos, voice files, photos ecc use the <code>send_photo</code> function (remember to change the safety Regex @ line 14 of command.sh to allow sending files only from certain directories):</p> <p>To send images, videos, voice files, photos ecc use the <code>send_photo</code> function (remember to change the safety Regex @ line 14 of command.sh to allow sending files only from certain directories):</p>
<pre><code>send_file "${USER[ID]}" "/home/user/doge.jpg" "Lool" <pre><code>send_file "${CHAT[ID]}" "/home/user/doge.jpg" "Lool"
</code></pre> </code></pre>
<p>To send custom keyboards use the <code>send_keyboard</code> function:</p> <p>To send custom keyboards use the <code>send_keyboard</code> function:</p>
<pre><code>send_keyboard "${USER[ID]}" "Text that will appear in chat?" "Yep" "No" <pre><code>send_keyboard "${CHAT[ID]}" "Text that will appear in chat?" "Yep" "No"
</code></pre> </code></pre>
<p>To send locations use the <code>send_location</code> function:</p> <p>To send locations use the <code>send_location</code> function:</p>
<pre><code>send_location "${USER[ID]}" "Latitude" "Longitude" <pre><code>send_location "${CHAT[ID]}" "Latitude" "Longitude"
</code></pre> </code></pre>
<p>To send venues use the <code>send_venue</code> function:</p> <p>To send venues use the <code>send_venue</code> function:</p>
<pre><code>send_venue "${USER[ID]}" "Latitude" "Longitude" "Title" "Address" "optional foursquare id" <pre><code>send_venue "${CHAT[ID]}" "Latitude" "Longitude" "Title" "Address" "optional foursquare id"
</code></pre> </code></pre>
<p>To forward messages use the <code>forward</code> function:</p> <p>To forward messages use the <code>forward</code> function:</p>
<pre><code>forward "${USER[ID]}" "from_chat_id" "message_id" <pre><code>forward "${CHAT[ID]}" "from_chat_id" "message_id"
</code></pre> </code></pre>
<p>To send a chat action use the <code>send_action</code> function. <p>To send a chat action use the <code>send_action</code> function.
Allowed values: typing for text messages, upload_photo for photos, record_video or upload_video for videos, record_audio or upload_audio for audio files, upload_document for general files, find_location for locations.</p> Allowed values: typing for text messages, upload_photo for photos, record_video or upload_video for videos, record_audio or upload_audio for audio files, upload_document for general files, find_location for locations.</p>
<pre><code>send_action "${USER[ID]}" "action" <pre><code>send_action "${CHAT[ID]}" "action"
</code></pre> </code></pre>
<p>To create interactive chats, write (or edit the question script) a normal bash (or C or python) script, chmod +x it and then change the argument of the startproc function to match the command you usually use to start the script. <p>To create interactive chats, write (or edit the question script) a normal bash (or C or python) script, chmod +x it and then change the argument of the startproc function to match the command you usually use to start the script.

File diff suppressed because one or more lines are too long

View File

@ -1,7 +1,7 @@
/* /*
The MIT License (MIT) The MIT License (MIT)
Copyright (c) 2015 GitHub, Inc. Copyright (c) 2016 GitHub, Inc.
Permission is hereby granted, free of charge, to any person obtaining a copy Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal of this software and associated documentation files (the "Software"), to deal
@ -27,18 +27,18 @@ SOFTWARE.
color: #969896; color: #969896;
} }
.pl-c1 /* constant, markup.raw, meta.diff.header, meta.module-reference, meta.property-name, support, support.constant, support.variable, variable.other.constant */, .pl-c1 /* constant, variable.other.constant, support, meta.property-name, support.constant, support.variable, meta.module-reference, markup.raw, meta.diff.header */,
.pl-s .pl-v /* string variable */ { .pl-s .pl-v /* string variable */ {
color: #0086b3; color: #0086b3;
} }
.pl-e /* entity */, .pl-e /* entity */,
.pl-en /* entity.name */ { .pl-en /* entity.name */ {
color: #795da3; color: #795da3;
} }
.pl-s .pl-s1 /* string source */, .pl-smi /* variable.parameter.function, storage.modifier.package, storage.modifier.import, storage.type.java, variable.other */,
.pl-smi /* storage.modifier.import, storage.modifier.package, storage.type.java, variable.other, variable.parameter.function */ { .pl-s .pl-s1 /* string source */ {
color: #333; color: #333;
} }
@ -50,13 +50,13 @@ SOFTWARE.
color: #a71d5d; color: #a71d5d;
} }
.pl-pds /* punctuation.definition.string, string.regexp.character-class */, .pl-s /* string */,
.pl-s /* string */, .pl-pds /* punctuation.definition.string, string.regexp.character-class */,
.pl-s .pl-pse .pl-s1 /* string punctuation.section.embedded source */, .pl-s .pl-pse .pl-s1 /* string punctuation.section.embedded source */,
.pl-sr /* string.regexp */, .pl-sr /* string.regexp */,
.pl-sr .pl-cce /* string.regexp constant.character.escape */, .pl-sr .pl-cce /* string.regexp constant.character.escape */,
.pl-sr .pl-sra /* string.regexp string.regexp.arbitrary-repitition */, .pl-sr .pl-sre /* string.regexp source.ruby.embedded */,
.pl-sr .pl-sre /* string.regexp source.ruby.embedded */ { .pl-sr .pl-sra /* string.regexp string.regexp.arbitrary-repitition */ {
color: #183691; color: #183691;
} }
@ -69,24 +69,24 @@ SOFTWARE.
} }
.pl-ii /* invalid.illegal */ { .pl-ii /* invalid.illegal */ {
background-color: #b52a1d;
color: #f8f8f8; color: #f8f8f8;
background-color: #b52a1d;
} }
.pl-sr .pl-cce /* string.regexp constant.character.escape */ { .pl-sr .pl-cce /* string.regexp constant.character.escape */ {
color: #63a35c;
font-weight: bold; font-weight: bold;
color: #63a35c;
} }
.pl-ml /* markup.list */ { .pl-ml /* markup.list */ {
color: #693a17; color: #693a17;
} }
.pl-mh /* markup.heading */, .pl-mh /* markup.heading */,
.pl-mh .pl-en /* markup.heading entity.name */, .pl-mh .pl-en /* markup.heading entity.name */,
.pl-ms /* meta.separator */ { .pl-ms /* meta.separator */ {
color: #1d3e81;
font-weight: bold; font-weight: bold;
color: #1d3e81;
} }
.pl-mq /* markup.quote */ { .pl-mq /* markup.quote */ {
@ -94,28 +94,28 @@ SOFTWARE.
} }
.pl-mi /* markup.italic */ { .pl-mi /* markup.italic */ {
color: #333;
font-style: italic; font-style: italic;
color: #333;
} }
.pl-mb /* markup.bold */ { .pl-mb /* markup.bold */ {
color: #333;
font-weight: bold; font-weight: bold;
color: #333;
} }
.pl-md /* markup.deleted, meta.diff.header.from-file */ { .pl-md /* markup.deleted, meta.diff.header.from-file */ {
background-color: #ffecec;
color: #bd2c00; color: #bd2c00;
background-color: #ffecec;
} }
.pl-mi1 /* markup.inserted, meta.diff.header.to-file */ { .pl-mi1 /* markup.inserted, meta.diff.header.to-file */ {
background-color: #eaffea;
color: #55a532; color: #55a532;
background-color: #eaffea;
} }
.pl-mdr /* meta.diff.range */ { .pl-mdr /* meta.diff.range */ {
color: #795da3;
font-weight: bold; font-weight: bold;
color: #795da3;
} }
.pl-mo /* meta.output */ { .pl-mo /* meta.output */ {