📝 Normaliza documentación
This commit is contained in:
parent
d489cb6e65
commit
8c6776b364
13 changed files with 128 additions and 52 deletions
|
|
@ -13,7 +13,7 @@
|
|||
|
||||
</div>
|
||||
|
||||
`PageTop` reivindica la sencillez de la web clásica utilizando SSR (*renderizado en el servidor*),
|
||||
`PageTop` reivindica la sencillez de la web clásica combinando SSR (*renderizado en el servidor*),
|
||||
HTML, CSS y JavaScript. Proporciona un conjunto completo de funcionalidades que pueden extenderse y
|
||||
adaptarse a las necesidades de cada solución web implementando:
|
||||
|
||||
|
|
@ -77,8 +77,7 @@ El repositorio se organiza en un *workspace* con los siguientes subproyectos:
|
|||
|
||||
* **[pagetop](https://github.com/manuelcillero/pagetop/tree/latest/pagetop)**, es la librería
|
||||
principal. Reúne algunos de los *crates* más estables y populares del ecosistema Rust para
|
||||
proporcionar APIs, patrones de desarrollo y buenas prácticas para la creación avanzada de
|
||||
soluciones web SSR (*Server-Side Rendering*).
|
||||
proporcionar APIs y recursos para la creación avanzada de soluciones web.
|
||||
|
||||
## Auxiliares
|
||||
|
||||
|
|
|
|||
|
|
@ -16,10 +16,11 @@ dinámicos, manejables y personalizables; y facilite a los usuarios la gestión
|
|||
contenidos de manera sencilla.
|
||||
|
||||
|
||||
# 📦 Sobre PageTop
|
||||
# 📌 Sobre PageTop
|
||||
|
||||
[PageTop](https://docs.rs/pagetop) es un entorno de desarrollo con convenciones que reivindican la
|
||||
sencillez de la web clásica aplicando *renderizado en el servidor* (SSR), HTML, CSS y JS.
|
||||
[PageTop](https://docs.rs/pagetop) es un entorno de desarrollo que reivindica la sencillez de la web
|
||||
clásica combinando SSR (*renderizado en el servidor*), HTML, CSS y JS, para crear soluciones web
|
||||
modulares, extensibles y configurables.
|
||||
|
||||
|
||||
# 🚧 Advertencia
|
||||
|
|
|
|||
|
|
@ -1,3 +1,21 @@
|
|||
//! <div align="center">
|
||||
//!
|
||||
//! <h1>Drust</h1>
|
||||
//!
|
||||
//! <p>Un Sistema de Gestión de Contenidos (CMS) basado en <strong>PageTop</strong> para compartir tu mundo.</p>
|
||||
//!
|
||||
//! [](#-license)
|
||||
//! [](https://crates.io/crates/drust)
|
||||
//! [](https://crates.io/crates/drust)
|
||||
//!
|
||||
//! </div>
|
||||
//!
|
||||
//! # 📌 Sobre PageTop
|
||||
//!
|
||||
//! [`PageTop`](https://docs.rs/pagetop) es un entorno de desarrollo que reivindica la sencillez de
|
||||
//! la web clásica combinando SSR (*renderizado en el servidor*), HTML, CSS y JS, para crear
|
||||
//! soluciones web modulares, extensibles y configurables.
|
||||
|
||||
use pagetop::prelude::*;
|
||||
|
||||
struct Drust;
|
||||
|
|
|
|||
|
|
@ -11,10 +11,11 @@
|
|||
|
||||
</div>
|
||||
|
||||
# 📦 Sobre PageTop
|
||||
# 📌 Sobre PageTop
|
||||
|
||||
[PageTop](https://docs.rs/pagetop) es un entorno de desarrollo con convenciones que reivindican la
|
||||
sencillez de la web clásica aplicando *renderizado en el servidor* (SSR), HTML, CSS y JS.
|
||||
[PageTop](https://docs.rs/pagetop) es un entorno de desarrollo que reivindica la sencillez de la web
|
||||
clásica combinando SSR (*renderizado en el servidor*), HTML, CSS y JS, para crear soluciones web
|
||||
modulares, extensibles y configurables.
|
||||
|
||||
|
||||
# 🚧 Advertencia
|
||||
|
|
|
|||
|
|
@ -1,7 +1,23 @@
|
|||
//! Incluye fácilmente archivos estáticos o archivos SCSS compilados directamente en el binario de
|
||||
//! tus aplicaciones `PageTop``.
|
||||
//! <div align="center">
|
||||
//!
|
||||
//! # Añadir al proyecto
|
||||
//! <h1>PageTop Build</h1>
|
||||
//!
|
||||
//! <p>Incluye fácilmente archivos estáticos o archivos SCSS compilados directamente en el binario de tus aplicaciones <strong>PageTop</strong>.</p>
|
||||
//!
|
||||
//! [](#-license)
|
||||
//! [](https://docs.rs/pagetop-build)
|
||||
//! [](https://crates.io/crates/pagetop-build)
|
||||
//! [](https://crates.io/crates/pagetop-build)
|
||||
//!
|
||||
//! </div>
|
||||
//!
|
||||
//! # 📌 Sobre PageTop
|
||||
//!
|
||||
//! [`PageTop`](https://docs.rs/pagetop) es un entorno de desarrollo que reivindica la sencillez de
|
||||
//! la web clásica combinando SSR (*renderizado en el servidor*), HTML, CSS y JS, para crear
|
||||
//! soluciones web modulares, extensibles y configurables.
|
||||
//!
|
||||
//! # ⚡️ Guía rápida
|
||||
//!
|
||||
//! Añade en el archivo `Cargo.toml` de tu aplicación:
|
||||
//!
|
||||
|
|
@ -10,12 +26,14 @@
|
|||
//! pagetop-build = { ... }
|
||||
//! ```
|
||||
//!
|
||||
//! Crea luego un archivo `build.rs` para definir cómo se van a incluir los archivos estáticos o
|
||||
//! archivos SCSS en tu aplicación, diseño o paquete de `PageTop`. Ejemplos de uso:
|
||||
//! Luego crea un archivo `build.rs` para definir cómo se van a incluir los archivos estáticos o
|
||||
//! archivos SCSS en tu aplicación. Casos de uso:
|
||||
//!
|
||||
//! ## 1. Incluir archivos estáticos desde un directorio
|
||||
//! ## Incluir archivos estáticos desde un directorio
|
||||
//!
|
||||
//! Prepara un conjunto de recursos con todos los archivos de un directorio:
|
||||
//! Prepara una carpeta en tu proyecto con todos los archivos que deseas incluir, por ejemplo
|
||||
//! `static`, y añade el siguiente código a tu archivo `build.rs` para crear tu conjunto de
|
||||
//! recursos:
|
||||
//!
|
||||
//! ```rust#ignore
|
||||
//! use pagetop_build::StaticFilesBundle;
|
||||
|
|
@ -27,54 +45,55 @@
|
|||
//! }
|
||||
//! ```
|
||||
//!
|
||||
//! O aplica un filtro para incluir únicamente archivos específicos:
|
||||
//! Si es necesario, puedes añadir un filtro para seleccionar archivos específicos de la carpeta:
|
||||
//!
|
||||
//! ```rust#ignore
|
||||
//! use pagetop_build::StaticFilesBundle;
|
||||
//! use std::path::Path;
|
||||
//!
|
||||
//! fn main() -> std::io::Result<()> {
|
||||
//! fn solo_archivos_css(path: &Path) -> bool {
|
||||
//! // Incluye solo archivos con la extensión `.css`.
|
||||
//! path.extension().map_or(false, |ext| ext == "css")
|
||||
//! fn only_pdf_files(path: &Path) -> bool {
|
||||
//! // Include only files with the `.pdf` extension.
|
||||
//! path.extension().map_or(false, |ext| ext == "pdf")
|
||||
//! }
|
||||
//!
|
||||
//! StaticFilesBundle::from_dir("./static", Some(solo_archivos_css))
|
||||
//! StaticFilesBundle::from_dir("./static", Some(only_pdf_files))
|
||||
//! .with_name("guides")
|
||||
//! .build()
|
||||
//! }
|
||||
//! ```
|
||||
//!
|
||||
//! ## 2. Compilar archivos SCSS a CSS
|
||||
//! ## Compilar archivos SCSS a CSS
|
||||
//!
|
||||
//! Crea un archivo CSS compilando un archivo SCSS, que puede importar otros a su vez, para preparar
|
||||
//! el conjunto de recursos:
|
||||
//! Puedes compilar un archivo SCSS, que podría importar otros a su vez, para preparar un conjunto
|
||||
//! de recursos con el archivo CSS obtenido. Por ejemplo:
|
||||
//!
|
||||
//! ```rust#ignore
|
||||
//! use pagetop_build::StaticFilesBundle;
|
||||
//!
|
||||
//! fn main() -> std::io::Result<()> {
|
||||
//! StaticFilesBundle::from_scss("./styles/main.scss", "main.css")
|
||||
//! StaticFilesBundle::from_scss("./styles/main.scss", "styles.css")
|
||||
//! .with_name("main_styles")
|
||||
//! .build()
|
||||
//! }
|
||||
//! ```
|
||||
//!
|
||||
//! Este código compila el archivo `main.scss`, incluyendo los archivos SCSS que importe, en un
|
||||
//! archivo `main.css` que definirá el conjunto de recursos `main_styles`.
|
||||
//! Este código compila el archivo `main.scss` de la carpeta `static` del proyecto, en un archivo
|
||||
//! `styles.css` que se preparará como un conjunto de recursos llamado `main_styles`.
|
||||
//!
|
||||
//!
|
||||
//! # Módulos generados
|
||||
//! # 📦 Módulos generados
|
||||
//!
|
||||
//! Cada [`StaticFilesBundle`] genera un archivo en el directorio estándar
|
||||
//! [OUT_DIR](https://doc.rust-lang.org/cargo/reference/environment-variables.html) donde se
|
||||
//! incluyen los recursos requeridos para compilar. Por ejemplo, si usas `with_name("guides")` se
|
||||
//! generará un archivo llamado `guides.rs`.
|
||||
//! Cada conjunto de recursos [`StaticFilesBundle`] genera un archivo en el directorio estándar
|
||||
//! [OUT_DIR](https://doc.rust-lang.org/cargo/reference/environment-variables.html#environment-variables-cargo-sets-for-build-scripts)
|
||||
//! donde se incluyen los recursos necesarios para la compilación. Por ejemplo, para
|
||||
//! `with_name("guides")` se crea un archivo llamado `guides.rs`.
|
||||
//!
|
||||
//! Ten en cuenta que puedes generar más de un conjunto de recursos para usar en tu proyecto.
|
||||
//!
|
||||
//! Normalmente no necesitarás acceder directamente a este archivo; simplemente inclúyelo en tu
|
||||
//! proyecto con `include_files!`, y luego configura un servicio web usando `include_files_service!`
|
||||
//! Normalmente no necesitarás acceder directamente a este archivo; sólo inclúyelo en tu proyecto
|
||||
//! con [`include_files!`](https://docs.rs/pagetop/latest/pagetop/macro.include_files.html), y luego
|
||||
//! configura un servicio web usando [`include_files_service!`](https://docs.rs/pagetop/latest/pagetop/macro.include_files_service.html)
|
||||
//! para servir tu conjunto de recursos desde la ruta indicada:
|
||||
//!
|
||||
//! ```rust#ignore
|
||||
|
|
@ -92,7 +111,7 @@
|
|||
//! }
|
||||
//! ```
|
||||
//!
|
||||
//! También puedes incluir el conjunto de recursos declarando un `HashMap` estático global:
|
||||
//! También podrías acceder a tu conjunto de recursos declarando un `HashMap` estático global:
|
||||
//!
|
||||
//! ```rust#ignore
|
||||
//! use pagetop::prelude::*;
|
||||
|
|
|
|||
|
|
@ -20,10 +20,11 @@ necesidad de referenciar `maud` o `smart_default` en las dependencias del archiv
|
|||
cada proyecto `PageTop`.
|
||||
|
||||
|
||||
# 📦 Sobre PageTop
|
||||
# 📌 Sobre PageTop
|
||||
|
||||
[PageTop](https://docs.rs/pagetop) es un entorno de desarrollo con convenciones que reivindican la
|
||||
sencillez de la web clásica aplicando *renderizado en el servidor* (SSR), HTML, CSS y JS.
|
||||
[PageTop](https://docs.rs/pagetop) es un entorno de desarrollo que reivindica la sencillez de la web
|
||||
clásica combinando SSR (*renderizado en el servidor*), HTML, CSS y JS, para crear soluciones web
|
||||
modulares, extensibles y configurables.
|
||||
|
||||
|
||||
# 🚧 Advertencia
|
||||
|
|
|
|||
|
|
@ -1,4 +1,21 @@
|
|||
//! Una colección de macros que impulsan el desarrollo con `PageTop`.
|
||||
//! <div align="center">
|
||||
//!
|
||||
//! <h1>PageTop Macros</h1>
|
||||
//!
|
||||
//! <p>Una colección de macros que mejoran la experiencia de desarrollo con <strong>PageTop</strong>.</p>
|
||||
//!
|
||||
//! [](#-license)
|
||||
//! [](https://docs.rs/pagetop-macros)
|
||||
//! [](https://crates.io/crates/pagetop-macros)
|
||||
//! [](https://crates.io/crates/pagetop-macros)
|
||||
//!
|
||||
//! </div>
|
||||
//!
|
||||
//! # 📌 Sobre PageTop
|
||||
//!
|
||||
//! [`PageTop`](https://docs.rs/pagetop) es un entorno de desarrollo que reivindica la sencillez de
|
||||
//! la web clásica combinando SSR (*renderizado en el servidor*), HTML, CSS y JS, para crear
|
||||
//! soluciones web modulares, extensibles y configurables.
|
||||
|
||||
mod maud;
|
||||
mod smart_default;
|
||||
|
|
|
|||
|
|
@ -5,7 +5,7 @@
|
|||
<p>Integra SeaORM para trabajar con bases de datos en aplicaciones <strong>PageTop</strong>.</p>
|
||||
|
||||
[](#-license)
|
||||
[](https://docs.rs/pagetop-seaorm)
|
||||
[](https://docs.rs/pagetop-seaorm)
|
||||
[](https://crates.io/crates/pagetop-seaorm)
|
||||
[](https://crates.io/crates/pagetop-seaorm)
|
||||
|
||||
|
|
@ -17,10 +17,11 @@ exportar sus funcionalidades, y también integra en código una versión adaptad
|
|||
permitir migraciones independientes para cada paquete del proyecto.
|
||||
|
||||
|
||||
# 📦 Sobre PageTop
|
||||
# 📌 Sobre PageTop
|
||||
|
||||
[PageTop](https://docs.rs/pagetop) es un entorno de desarrollo con convenciones que reivindican la
|
||||
sencillez de la web clásica aplicando *renderizado en el servidor* (SSR), HTML, CSS y JS.
|
||||
[PageTop](https://docs.rs/pagetop) es un entorno de desarrollo que reivindica la sencillez de la web
|
||||
clásica combinando SSR (*renderizado en el servidor*), HTML, CSS y JS, para crear soluciones web
|
||||
modulares, extensibles y configurables.
|
||||
|
||||
|
||||
# 🚧 Advertencia
|
||||
|
|
|
|||
|
|
@ -1,4 +1,4 @@
|
|||
//! Configuration settings for the SeaORM PageTop package.
|
||||
//! Opciones de configuración del paquete.
|
||||
//!
|
||||
//! Example:
|
||||
//!
|
||||
|
|
|
|||
|
|
@ -1,3 +1,22 @@
|
|||
//! <div align="center">
|
||||
//!
|
||||
//! <h1>PageTop SeaORM</h1>
|
||||
//!
|
||||
//! <p>Integra SeaORM para trabajar con bases de datos en aplicaciones <strong>PageTop</strong>.</p>
|
||||
//!
|
||||
//! [](#-license)
|
||||
//! [](https://docs.rs/pagetop-seaorm)
|
||||
//! [](https://crates.io/crates/pagetop-seaorm)
|
||||
//! [](https://crates.io/crates/pagetop-seaorm)
|
||||
//!
|
||||
//! </div>
|
||||
//!
|
||||
//! # 📌 Sobre PageTop
|
||||
//!
|
||||
//! [`PageTop`](https://docs.rs/pagetop) es un entorno de desarrollo que reivindica la sencillez de
|
||||
//! la web clásica combinando SSR (*renderizado en el servidor*), HTML, CSS y JS, para crear
|
||||
//! soluciones web modulares, extensibles y configurables.
|
||||
|
||||
use pagetop::prelude::*;
|
||||
|
||||
use std::sync::LazyLock;
|
||||
|
|
@ -5,7 +24,7 @@ use std::sync::LazyLock;
|
|||
pub mod config;
|
||||
pub mod db;
|
||||
|
||||
/// The package Prelude.
|
||||
/// *Prelude* del paquete.
|
||||
pub mod prelude {
|
||||
pub use crate::db;
|
||||
pub use crate::install_migrations;
|
||||
|
|
@ -13,7 +32,7 @@ pub mod prelude {
|
|||
|
||||
include_locales!(LOCALES_SEAORM);
|
||||
|
||||
/// Implements [`PackageTrait`] and specific package API.
|
||||
/// Implementa [`PackageTrait`] y API específica.
|
||||
pub struct SeaORM;
|
||||
|
||||
impl PackageTrait for SeaORM {
|
||||
|
|
|
|||
|
|
@ -1,4 +1,4 @@
|
|||
//! Carga los ajustes de configuración.
|
||||
//! Carga las opciones de configuración.
|
||||
//!
|
||||
//! These settings are loaded from [TOML](https://toml.io) files as `key = value` pairs and mapped
|
||||
//! into type-safe structures with predefined values.
|
||||
|
|
|
|||
|
|
@ -1,4 +1,4 @@
|
|||
//! Ajustes globales de `PageTop`.
|
||||
//! Opciones globales de configuración de `PageTop`.
|
||||
|
||||
use crate::include_config;
|
||||
|
||||
|
|
|
|||
|
|
@ -14,7 +14,7 @@
|
|||
//! <br>
|
||||
//! </div>
|
||||
//!
|
||||
//! `PageTop` reivindica la sencillez de la web clásica utilizando SSR (*renderizado en el
|
||||
//! `PageTop` reivindica la sencillez de la web clásica combinando SSR (*renderizado en el
|
||||
//! servidor*), HTML, CSS y JavaScript. Proporciona un conjunto completo de funcionalidades que
|
||||
//! pueden extenderse y adaptarse a las necesidades de cada solución web implementando:
|
||||
//!
|
||||
|
|
@ -28,7 +28,7 @@
|
|||
//! * **Paquetes** (*packages*). Extienden o personalizan funcionalidades existentes interactuando
|
||||
//! con las APIs de `PageTop` o de paquetes de terceros.
|
||||
//!
|
||||
//! # ⚡️ Inicio rápido
|
||||
//! # ⚡️ Guía rápida
|
||||
//!
|
||||
//! La aplicación más sencilla de `PageTop` se ve así:
|
||||
//!
|
||||
|
|
@ -96,9 +96,9 @@ pub type Weight = i8;
|
|||
|
||||
// Funciones y macros útiles.
|
||||
pub mod util;
|
||||
// Carga los ajustes de configuración.
|
||||
// Carga las opciones de configuración.
|
||||
pub mod config;
|
||||
// Ajustes globales.
|
||||
// Opciones de configuración globales.
|
||||
pub mod global;
|
||||
// Gestión de trazas y registro de eventos de la aplicación.
|
||||
pub mod trace;
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue