Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Update parse mode plugin docs #520

Merged
merged 20 commits into from
Dec 30, 2022
Merged

Update parse mode plugin docs #520

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
20 commits
Select commit Hold shift + click to select a range
3309cc9
Update Parse Mode plugin docs
KnightNiwrem Oct 8, 2022
24cd3c9
Run docs:fmt
KnightNiwrem Oct 8, 2022
8b4ee76
Update site/docs/plugins/parse-mode.md
KnightNiwrem Oct 12, 2022
287cf34
Update site/docs/plugins/parse-mode.md
KnightNiwrem Oct 12, 2022
1d920d3
Update site/docs/plugins/parse-mode.md
KnightNiwrem Oct 12, 2022
cd0e0fb
Apply suggestions from code review
rojvv Dec 29, 2022
9c68010
Apply suggestions from code review
rojvv Dec 29, 2022
c24e21e
Update site/docs/plugins/parse-mode.md
rojvv Dec 29, 2022
0bd24a2
Apply suggestions from code review
rojvv Dec 30, 2022
683883d
Merge branch 'main' into update-parse-mode
habemuscode Dec 30, 2022
0592ca8
Add `link` to import list
Dec 30, 2022
f47f4bb
Sync changes to Indonesian
Dec 30, 2022
c12a523
Remove `composer` from import list
Dec 30, 2022
91c3c25
Add Spanish
habemuscode Dec 30, 2022
1ec703b
Format English
habemuscode Dec 30, 2022
054dfc9
Merge branch 'update-parse-mode' of github.com:grammyjs/website into …
habemuscode Dec 30, 2022
413932b
Update site/docs/es/plugins/parse-mode.md
habemuscode Dec 30, 2022
3d49b75
Update site/docs/es/plugins/parse-mode.md
habemuscode Dec 30, 2022
91cde47
Remove Composer from dependencies
habemuscode Dec 30, 2022
ec88330
Fix and to y
habemuscode Dec 30, 2022
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
144 changes: 127 additions & 17 deletions site/docs/es/plugins/parse-mode.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,28 +2,138 @@

Este plugin proporciona un transformador para establecer el `parse_mode` por defecto, y un middleware para hidratar el `Context` con los métodos variantes familiares de `reply` - es decir, `replyWithHTML`, `replyWithMarkdown`, etc.

## Uso
## Uso (Mejorar la experiencia de formateo)

<CodeGroup>
<CodeGroupItem title="TypeScript" active>

```ts
import { Bot } from "grammy";
import { Bot, Context } from "grammy";
import { bold, fmt, hydrateReply, italic, link } from "@grammyjs/parse-mode";

import type { ParseModeFlavor } from "@grammyjs/parse-mode";

const bot = new Bot<ParseModeFlavor<Context>>("");

// Instalar el plugin.
bot.use(hydrateReply);

bot.command("demo", async (ctx) => {
await ctx.replyFmt(fmt`${bold("negrita!")}
${bold(italic("ambas!"))}
${bold(fmt`negrita ${link("blink", "example.com")} negrita`)}`);

// fmt también puede ser llamada como cualquier otra función.
await ctx.replyFmt(
fmt(
["", " y ", " y ", ""],
fmt`${bold("negrita")}`,
fmt`${bold(italic("ambas"))}`,
fmt`${italic("cursiva")}`,
),
);
});

bot.start();
```

</CodeGroupItem>
<CodeGroupItem title="JavaScript">

```js
const { Bot, Context } = require("grammy");
const { bold, fmt, hydrateReply, italic, link } = require(
"@grammyjs/parse-mode",
);

const bot = new Bot("");

// Instalar el plugin.
bot.use(hydrateReply);

bot.command("demo", async (ctx) => {
await ctx.replyFmt(fmt`${bold("negrita!")}
${bold(italic("ambas!"))}
${bold(fmt`negrita ${link("blink", "example.com")} negrita`)}`);

// fmt también puede ser llamada como cualquier otra función.
await ctx.replyFmt(
fmt(
["", " y ", " y ", ""],
fmt`${bold("negrita")}`,
fmt`${bold(italic("ambas"))}`,
fmt`${italic("cursiva")}`,
),
);
});

bot.start();
```

</CodeGroupItem>
<CodeGroupItem title="Deno">

```ts
import { Bot, Context } from "https://deno.land/x/grammy/mod.ts";
import {
bold,
fmt,
hydrateReply,
italic,
link,
} from "https://deno.land/x/grammy_parse_mode/mod.ts";

import type { ParseModeFlavor } from "https://deno.land/x/grammy_parse_mode/mod.ts";

const bot = new Bot<ParseModeFlavor<Context>>("");

// Instalar el plugin.
bot.use(hydrateReply);

bot.command("demo", async (ctx) => {
await ctx.replyFmt(fmt`${bold("negrita!")}
${bold(italic("ambas!"))}
${bold(fmt`negrita ${link("blink", "example.com")} negrita`)}`);

// fmt también puede ser llamada como cualquier otra función.
await ctx.replyFmt(
fmt(
["", " y ", " y ", ""],
fmt`${bold("negrita")}`,
fmt`${bold(italic("ambas"))}`,
fmt`${italic("cursiva")}`,
),
);
});

bot.start();
```

</CodeGroupItem>
</CodeGroup>

## Uso (modo de análisis sintáctico por defecto y métodos de respuesta)

<CodeGroup>
<CodeGroupItem title="TypeScript" active>

```ts
import { Bot, Context } from "grammy";
import { hydrateReply, parseMode } from "@grammyjs/parse-mode";

import type { ParseModeContext } from "@grammyjs/parse-mode";
import type { ParseModeFlavor } from "@grammyjs/parse-mode";

const bot = new Bot<ParseModeContext>("");
const bot = new Bot<ParseModeFlavor<Context>>("");

// Usa el plugin.
// Instalar el plugin.
bot.use(hydrateReply);

// Establece el parse_mode por defecto para ctx.reply
// Establece el modo de formateo por defecto de `ctx.reply`.
bot.api.config.use(parseMode("MarkdownV2"));

bot.command("demo", async (ctx) => {
await ctx.reply(
"*Esta* respuesta utiliza _MarkdownV2_ como `formato` por defecto",
"*Este* es _el_ `formato` por defecto",
);
await ctx.replyWithHTML(
"<b>Este</b> es el <code>formato</code> <i>conHTML</i>",
Expand All @@ -40,20 +150,20 @@ bot.start();
<CodeGroupItem title="JavaScript">

```js
const { Bot } = require("grammy");
const { Bot, Context } = require("grammy");
const { hydrateReply, parseMode } = require("@grammyjs/parse-mode");

const bot = new Bot("");

// Usa el plugin.
// Instalar el plugin.
bot.use(hydrateReply);

// Establece el `parse_mode` por defecto de `ctx.reply`.
// Establece el modo de formateo por defecto de `ctx.reply`.
bot.api.config.use(parseMode("MarkdownV2"));

bot.command("demo", async (ctx) => {
await ctx.reply(
"*Esta* respuesta utiliza _MarkdownV2_ como `formato` por defecto",
"*Este* es _el_ `formato` por defecto",
);
await ctx.replyWithHTML(
"<b>Este</b> es el <code>formato</code> <i>conHTML</i>",
Expand All @@ -70,25 +180,25 @@ bot.start();
<CodeGroupItem title="Deno">

```ts
import { Bot } from "https://deno.land/x/grammy/mod.ts";
import { Bot, Context } from "https://deno.land/x/grammy/mod.ts";
import {
hydrateReply,
parseMode,
} from "https://deno.land/x/grammy_parse_mode/mod.ts";

import type { ParseModeContext } from "https://deno.land/x/grammy_parse_mode/mod.ts";
import type { ParseModeFlavor } from "https://deno.land/x/grammy_parse_mode/mod.ts";

const bot = new Bot<ParseModeContext>("");
const bot = new Bot<ParseModeFlavor<Context>>("");

// Usa el plugin.
// Instalar el plugin.
bot.use(hydrateReply);

// Establece el `parse_mode` por defecto de `ctx.reply`.
// Establece el modo de formateo por defecto de `ctx.reply`.
bot.api.config.use(parseMode("MarkdownV2"));

bot.command("demo", async (ctx) => {
await ctx.reply(
"*Esta* respuesta utiliza _MarkdownV2_ como `formato` por defecto",
"*Este* es _el_ `formato` por defecto",
);
await ctx.replyWithHTML(
"<b>Este</b> es el <code>formato</code> <i>conHTML</i>",
Expand Down
Loading