Curso Intensivo de TypeScript para contenido de CMS sin cabeza

Rate this content
Bookmark

En este masterclass, primero te mostraré cómo crear un nuevo proyecto en un CMS sin cabeza, llenarlo con datos y usar el contenido en tu proyecto. Luego, pasaremos el resto del tiempo en código, haremos lo siguiente:

- Generar modelos y estructuras de tipo fuertemente tipados para el contenido obtenido.

- Usar el contenido en componentes

- Resolver contenido de campos de texto enriquecido en componentes de React

- Tocar los pipelines de implementación y las posibilidades de descubrir problemas relacionados con el contenido antes de llegar a producción

This workshop has been presented at TypeScript Congress 2022, check out the latest edition of this JavaScript Conference.

FAQ

Un CMS sin cabeza es un sistema de gestión de contenido que proporciona una forma de trabajar con contenido a través de una API, pero sin una interfaz de usuario predeterminada para la presentación del contenido. Esto permite una mayor flexibilidad en cómo se entrega y se presenta el contenido en diferentes plataformas.

Para importar contenido en un nuevo proyecto utilizando TypeScript, puedes usar un paquete de importación específico como se demostró en la masterclass, donde se usó el 'content workshop import package.zip'. Deberás configurar la clave de administración y utilizar el administrador de plantillas de contenido para importar este paquete a tu proyecto.

Un 'Modelo Atacado Fuertemente' en el contexto de CMS se refiere a la práctica de definir explícitamente los tipos de datos y estructuras en el código, como se hizo en TypeScript durante la masterclass. Esto ayuda a manejar cambios en el modelo de contenido de manera más fluida y segura, asegurando que el código se mantenga actualizado con el diseño del contenido.

Para verificar el contenido importado en un CMS sin cabeza, puedes utilizar la URL del CDN proporcionada por el CMS junto con el ID del proyecto. Esto te permitirá acceder a un JSON con los elementos de contenido que actualmente se encuentran en el proyecto, lo que facilita la verificación de que el contenido se ha importado correctamente.

Para seguir una masterclass práctica de CMS sin cabeza necesitas tener instalado Visual Studio Code, una conexión a Internet, y posiblemente acceso a un repositorio de GitHub si se proporciona un proyecto de ejemplo. No es necesario tener experiencia previa con el CMS, ya que se pueden proporcionar los IDs y las herramientas necesarias durante la sesión.

Para resolver campos de texto enriquecido en componentes React utilizando un CMS sin cabeza, puedes utilizar un elemento de texto enriquecido de una biblioteca externa que te permite definir cómo se deben renderizar los diferentes tipos de contenido (como imágenes, enlaces y componentes) dentro del contenido enriquecido.

Ondrej Polesny
Ondrej Polesny
118 min
24 May, 2022

Comments

Sign in or register to post your comment.
Video Summary and Transcription
Este masterclass proporciona una introducción al trabajo con contenido en TypeScript utilizando CMS. Cubre temas como la generación de modelos de TypeScript, la implementación de Next.js, la resolución de campos de texto enriquecido y la mejora de la seguridad de tipos y la mantenibilidad del código. El masterclass también discute la importación de paquetes de contenido, la solución de problemas y la generación automática de modelos. Se enfatiza la importancia de generar modelos de tipo fuertemente tipados para el contenido y se demuestra cómo resolver elementos de texto enriquecido en componentes de React.

1. Introducción a CMS y Descripción General del Masterclass

Short description:

¡Hola a todos! Soy Andrey, un evangelista de desarrollo para Contentby. Hoy les mostraré cómo trabajar con contenido en TypeScript utilizando CMS. Cubriremos temas como Modelos Atacados Fuertemente, generando modelos de contenido en TypeScript, implementando Next.js, resolviendo campos de texto enriquecido y más. También discutiremos los pipelines de implementación y la verificación de contenido. Si están interesados, comencemos. Pueden ver o unirse al masterclass práctico. Les proporcionaré un enlace a un repositorio que pueden clonar y los guiaré a través de la implementación. No se requiere registro, pero si desean usar el CMS sin cabeza, hay una prueba gratuita disponible. ¡Sumergámonos!

Así que, hola a todos, una vez más. Espero que la mayoría de los asistentes que quieran unirse aquí hoy estén presentes. Permítanme presentarme primero y espero que todos puedan ver mi pantalla, así que les mostraré la segunda diapositiva de la presentación donde describiré lo que vamos a ver hoy. Soy Andrey, trabajo como evangelista de desarrollo para Contentby. Voy a mostrarles un poco de CMS. Quiero enfatizar que hoy no estoy haciendo una presentación de producto, solo estoy tratando de mostrarles cómo podemos trabajar con contenido en TypeScript, y espero que los principios que les mostraré sean aplicables a otros CMS, siempre y cuando tengan herramientas similares, lo cual espero que tengan.

Solía trabajar en el departamento de éxito del cliente durante bastante tiempo, así que creo que tengo experiencia en cómo las personas luchan con lo que sucede cuando su proyecto crece, y cuando sus modelos de contenido cambian. No sé si para todos los desarrolladores, pero diría que para la mayoría de nosotros. Saben que cuando están configurando sus modelos, sus bases de datos, todo al inicio de su proyecto, nunca se mantienen iguales. Siempre terminan cambiando muchas cosas, a veces incluso replataformando todo su proyecto, así que les mostraré cómo los Modelos Atacados Fuertemente pueden ayudarles a hacer ese proceso más fluido. Nunca será perfecto, pero al menos podemos intentar ser optimistas sobre el cambio.

Muy bien, déjenme cambiar aquí. Hoy, se estima que el masterclass durará tres horas. Intentaré ser un poco más rápido que eso. Veremos cómo va. Lo que quiero hacer al principio es que en realidad tenemos un paquete de importación que les mostraré cómo importar en un nuevo proyecto. Luego les mostraré cómo podemos generar el modelo de contenido en código, en TypeScript. Así que, les mostraré el contenido en el CMS. Les mostraré la implementación de Next.js. He preparado un paquete para ustedes que pueden obtener clonando desde GitHub. Generaremos los modelos de TypeScript. Y luego implementaremos una página adicional en la implementación de Next.js que obtendrá contenido, contenido de tipo fuerte. Y resolveremos campos de texto enriquecido en componentes React. Así que, mantendremos los modelos de tipo fuerte con el contenido. Y resolveremos incluso el texto enriquecido para que los especialistas en marketing puedan trabajar en sus páginas de destino sin tu ayuda, y tú puedas mantener tipos fuertes en tu implementación. Al final, también podemos discutir los pipelines de implementación y la verificación de contenido. Esto se basa en nuestra propia experiencia cuando hemos tenido muchos problemas e inconsistencias entre las implementaciones del sitio web y lo que realmente estaba en el CMS. Y cuando el modelo de contenido del CMS cambia, tu sitio web y tu sitio web no están preparados para el cambio. Puede terminar con un error desagradable. Así que puedo contarles en qué estamos trabajando actualmente y cuáles son algunas de las formas en que podemos evitar estos errores. Genial.

Entonces, si esto suena bien, podemos pasar al primer paso del masterclass. Ahora, mi objetivo es hacer esto como un masterclass práctico, por lo que solo necesitan, si tienen Visual Studio y una conexión a Internet, eso es todo lo que realmente necesitan. Pero si solo quieren ver, siéntanse libres de hacerlo. Si quieren usar mi proyecto del contenido, del CMS sin cabeza, eso también es posible. Les compartiré el ID del proyecto, por lo que no tendrán que trabajar con el contenido. Pueden quedarse en su Visual Studio code y trabajar con el contenido allí. No es necesario registrarse. Si no quieren hacerlo, está bien. Si lo desean, también pueden hacerlo. Este es un enlace a un repositorio que pueden clonar. Permítanme ir allí por un segundo. Debería ser público, por lo que deberían poder acceder a él. Lo único que necesitan hacer es hacer un git clone en este repositorio. ¿Quizás alguien pueda ponerlo en el chat, o puedo hacerlo yo? Sí. Oh, gracias. Muchas gracias. Siéntanse libres de clonarlo. Voy a pasar a la implementación en un segundo. Lo único que quería decirles es que este es un sitio basado en Next.js. Next.js es el framework más utilizado para la mayoría de nuestros clientes. Te brinda mucha flexibilidad y muchas características nuevas mientras mantienes la implementación mantenible. Lo usamos en nuestro propio sitio, por lo que también es el paso más fácil para mí. Cuando clonen esto, podemos echarle un vistazo en VS Code. Voy a abrirlo aquí. Lo haré un poco más grande. Avísenme si pueden leerlo bien. De lo contrario, puedo hacerlo aún más grande. Cuando descarguen o clonen el proyecto, hay una cosa importante, y es el paquete de importación del masterclass de contenido. Si no quieren registrarse en el contenido y solo quieren usar Mi Proyecto, está bien. Si quieren registrarse en el contenido, entonces hay una prueba. Si van a content.ai. Aquí pueden obtener un plan de desarrollador gratuito. Hay un enlace a una página de registro. Pueden registrarse para la prueba. Y les mostraré cómo importar contenido en un proyecto en blanco. Si no quieren registrarse, está bien. De todos modos, lo haré yo. Y les compartiré el ID. De hecho, creo que el ID del proyecto está aquí en el readme del repositorio. Esto es lo único que necesitarán para el masterclass en términos del CMS sin cabeza.

2. Importación del Paquete de Contenido y Verificación del Contenido

Short description:

Para importar el paquete de contenido en tu proyecto, ve al administrador de plantillas de contenido y sigue los pasos para importar el paquete. Asegúrate de generar la clave de administración en la configuración del proyecto y habilitar la API de administración. Arrastra y suelta el paquete en el administrador de plantillas de contenido y marca la casilla para publicar las variantes de idioma después de la importación. Una vez que la importación haya finalizado, tendrás todo el contenido en el proyecto. Puedes verificar el contenido accediendo al sitio web deliver.content.ai e ingresando el ID del proyecto. Además, puedes usar el ID del proyecto para acceder a los elementos de contenido en formato JSON. Si necesitas el administrador de plantillas, puedes encontrarlo buscando 'administrador de plantillas de contenido' en Google o visitando kentico.github.io/content-template-manager.

Ahora, permíteme cambiar al proyecto correcto. Entonces, cuando te registras para el contenido y creas un nuevo proyecto, verás esto. Esta es una pantalla vacía. No hay contenido aquí. Nada. Es completamente un proyecto en blanco. Y este es el ID que voy a usar. Sí, ves que es 02A. Es el mismo que está aquí. 02A, correcto. Entonces, lo que haga en el proyecto, puedes consumirlo usando el ID del proyecto.

Ahora, lo primero que quiero hacer es importar el paquete de contenido, ¿de acuerdo? Entonces, hay un paquete de contenido llamado content workshop import package.zip. Esto es algo que quiero importar a mi proyecto de contenido. Ahora, para, oops, crear una nueva pestaña. Perfecto. Ahora, para el contenido, hay una cosa llamada administrador de plantillas de contenido que te permite hacer una copia de seguridad de tu proyecto, ¿de acuerdo? Puedes exportar, importar, incluso hay plantillas que puedes usar. Ahora, cuando preparé el proyecto, hice una exportación. Ahora, voy a hacer una importación, ¿de acuerdo? El ID del proyecto de destino es el que te mostré. Ahora, por un momento, voy a ir a la configuración del proyecto y generar la clave de administración. Entonces, si quieres importar en tu propio proyecto, tendrás que hacer lo mismo, ir a la configuración del proyecto, claves de API y habilitar la API de administración. Así que, activaré esto y copiaré la clave. Como la API de administración está disponible en todos los planes, incluso en el plan gratuito para desarrolladores, ¿verdad? Y la pegaré aquí. Y lo último que necesito hacer es arrastrar y soltar el paquete. Así que déjame encontrar la carpeta correcta. Esa será......esta. Aquí, ves que este es el paquete de importación de Content Workshop, así que lo arrastraré aquí. Y quiero publicar las variantes de idioma después de la importación, así que si estás importando en tu proyecto, haz lo mismo, simplemente arrástralo y suéltalo aquí. Ingresa un ID de proyecto, clave de API de administración de contenido, marca esta casilla y prepárate para la importación. Pero no debería haber errores, así que nuestras data inconsistencias son 0, por lo que obtienes un informe de estado agradable. No hay problemas, así que puedo proceder con la importación de data. Esto tomará un segundo, pero una vez que haya terminado, tendremos todo el contenido en el proyecto, ¿de acuerdo? Así que ves que data se importó correctamente, así que cerraré esto. Oops, no quería hacer eso. Déjame ver. Así es el proyecto. Volvamos a cambiar a contenido. Ahora ves que tengo tres elementos de contenido aquí y también debería tener algunos activos aquí, ¿verdad? Así que tenemos tres imágenes, tres elementos de contenido, así que todo está como debería ser. Ahora, si te preguntas cómo vamos a obtener el contenido y ahora tienes el ID del proyecto, ¿verdad? Nuevamente, el ID del proyecto está en el README del repositorio que se compartió, ¿verdad? Esta parte aquí. Ahora lo que puedes hacer es verificar que el contenido llegue al CDN, ¿verdad? Entonces, si vas a deliver.content.ai y pones allí el ID del proyecto, deliver.content.ai slash el ID del proyecto y slash items, deberías obtener un bonito JSON correspondiente a los elementos de contenido que actualmente tenemos en el proyecto, ¿verdad? Probablemente no te diga mucho, pero ves que hay un elemento HawkIce Rock. Hay una página de respuesta de mercado. Así que prácticamente todos los elementos que actualmente tenemos en el sistema. Entonces, esta es la primera cosa que puedes verificar si puedes acceder a esto. Brittany, si estás buscando el administrador de plantillas, intentaré llegar allí. Pero lo que puedes hacer es buscar en Google 'administrador de plantillas de contenido'. Será el primer enlace. De lo contrario, está en kentico.github.io slash content template manager. Ahora, lo que van a ver es esta pantalla. Ahora lo importé en mi proyecto. Para eso vas a necesitar un ID de proyecto y la clave de API de administración. Si no tienes eso, está bien. Puedes usar el mío. El proyecto que ya importé. Así que está perfectamente bien. Perfecto. Y por supuesto, si quieres importar, podemos darte unos momentos. Está bien. Entonces, lo que ves en el CMS son tres elementos aquí. Pero volvamos al Modelo de Contenido. Ahora, quiero mostrarte la estructura del sitio. En el sitio, actualmente tienes tres tipos de contenido. El tipo de contenido raíz, lo llamaría, se llama Página de Aterrizaje. Y la Página de Aterrizaje es algo que está preparado para un editor de contenido, un especialista en marketing, podrías decir. Tiene cada página que se basa en este tipo de contenido. Tendrá un título. Tendrá un contenido y una URL de slug, ¿verdad? URL de slug para que sepamos dónde colocar ese contenido. Título para que nombremos la página de alguna manera. Y el texto enriquecido será un lugar donde los especialistas en marketing pueden crear sus componentes, donde pueden crear el design de la página.

QnA

Watch more workshops on topic

React, TypeScript y TDD
React Advanced 2021React Advanced 2021
174 min
React, TypeScript y TDD
Top Content
Featured WorkshopFree
Paul Everitt
Paul Everitt
ReactJS es extremadamente popular y, por lo tanto, ampliamente soportado. TypeScript está ganando popularidad y, por lo tanto, cada vez más soportado.

¿Los dos juntos? No tanto. Dado que ambos cambian rápidamente, es difícil encontrar materiales de aprendizaje precisos.

¿React+TypeScript, con los IDEs de JetBrains? Esa combinación de tres partes es el tema de esta serie. Mostraremos un poco sobre mucho. Es decir, los pasos clave para ser productivo, en el IDE, para proyectos de React utilizando TypeScript. En el camino, mostraremos el desarrollo guiado por pruebas y enfatizaremos consejos y trucos en el IDE.
Dominando conceptos avanzados en TypeScript
React Summit US 2023React Summit US 2023
132 min
Dominando conceptos avanzados en TypeScript
Top Content
Featured WorkshopFree
Jiri Lojda
Jiri Lojda
TypeScript no es solo tipos e interfaces. Únete a esta masterclass para dominar características más avanzadas de TypeScript que harán tu código a prueba de balas. Cubriremos tipos condicionales y notación de inferencia, cadenas de plantillas y cómo mapear sobre tipos de unión y propiedades de objetos/arrays. Cada tema se demostrará en una aplicación de muestra que se escribió con tipos básicos o sin tipos en absoluto y juntos mejoraremos el código para que te familiarices más con cada característica y puedas llevar este nuevo conocimiento directamente a tus proyectos.
Aprenderás:- - ¿Qué son los tipos condicionales y la notación de inferencia?- ¿Qué son las cadenas de plantillas?- Cómo mapear sobre tipos de unión y propiedades de objetos/arrays.
Consejos y Trucos Profundos de TypeScript
Node Congress 2024Node Congress 2024
83 min
Consejos y Trucos Profundos de TypeScript
Top Content
Featured Workshop
Josh Goldberg
Josh Goldberg
TypeScript tiene un sistema de tipos poderoso con todo tipo de características sofisticadas para representar estados de JavaScript salvajes y extravagantes. Pero la sintaxis para hacerlo no siempre es sencilla, y los mensajes de error no siempre son precisos al decirte qué está mal. Vamos a profundizar en cómo funcionan muchas de las características más poderosas de TypeScript, qué tipos de problemas del mundo real resuelven, y cómo dominar el sistema de tipos para que puedas escribir código TypeScript verdaderamente excelente.
Mejores Prácticas y Consejos Avanzados de TypeScript para Desarrolladores de React
React Advanced 2022React Advanced 2022
148 min
Mejores Prácticas y Consejos Avanzados de TypeScript para Desarrolladores de React
Top Content
Featured Workshop
Maurice de Beijer
Maurice de Beijer
¿Eres un desarrollador de React tratando de obtener los máximos beneficios de TypeScript? Entonces esta es la masterclass para ti.En esta masterclass interactiva, comenzaremos desde lo básico y examinaremos los pros y contras de las diferentes formas en que puedes declarar componentes de React usando TypeScript. Después de eso, pasaremos a conceptos más avanzados donde iremos más allá de la configuración estricta de TypeScript. Aprenderás cuándo usar tipos como any, unknown y never. Exploraremos el uso de predicados de tipo, guardias y comprobación exhaustiva. Aprenderás sobre los tipos mapeados incorporados, así como cómo crear tus propias utilidades de mapa de tipo nuevo. Y comenzaremos a programar en el sistema de tipos de TypeScript usando tipos condicionales e inferencia de tipos.
Desarrollo sin fricciones con un sistema de tipos unificado
JSNation 2024JSNation 2024
113 min
Desarrollo sin fricciones con un sistema de tipos unificado
Featured Workshop
Ejiro Asiuwhu
Ejiro Asiuwhu
Imagina desarrollar donde el frontend y el backend cantan en armonía, los tipos bailan en perfecta sincronía y los errores se convierten en un recuerdo lejano. ¡Eso es la magia de TypeScript Nirvana!
Únete a mí en un viaje para descubrir los secretos de las definiciones de tipos unificadas, la clave para desbloquear un desarrollo sin fricciones. Nos sumergiremos en:
- Lenguaje compartido, amor compartido: Define los tipos una vez y compártelos en todas partes. La consistencia se convierte en tu mejor amiga, los errores en tu peor pesadilla (uno que rara vez verás).- Codificación sin esfuerzo: Olvídate de la tediosa tarea de comprobar tipos manualmente. TypeScript te respalda, liberándote para centrarte en construir cosas increíbles.- Magia de mantenibilidad: Con tipos claros que guían tu código, mantenerlo se convierte en un paseo por el parque. Más tiempo para innovar, menos tiempo para depurar.- Fortaleza de seguridad: El sistema de tipos de TypeScript protege tu aplicación de vulnerabilidades comunes, convirtiéndola en una fortaleza contra amenazas de seguridad.

Check out more articles and videos

We constantly think of articles and videos that might spark Git people interest / skill us up or help building a stellar career

Los tipos más útiles de React
React Day Berlin 2023React Day Berlin 2023
21 min
Los tipos más útiles de React
Top Content
Today's Talk focuses on React's best types and JSX. It covers the types of JSX and React components, including React.fc and React.reactnode. The discussion also explores JSX intrinsic elements and react.component props, highlighting their differences and use cases. The Talk concludes with insights on using React.componentType and passing components, as well as utilizing the react.element ref type for external libraries like React-Select.
TypeScript y React: Secretos de un matrimonio feliz
React Advanced 2022React Advanced 2022
21 min
TypeScript y React: Secretos de un matrimonio feliz
Top Content
React and TypeScript have a strong relationship, with TypeScript offering benefits like better type checking and contract enforcement. Failing early and failing hard is important in software development to catch errors and debug effectively. TypeScript provides early detection of errors and ensures data accuracy in components and hooks. It offers superior type safety but can become complex as the codebase grows. Using union types in props can resolve errors and address dependencies. Dynamic communication and type contracts can be achieved through generics. Understanding React's built-in types and hooks like useState and useRef is crucial for leveraging their functionality.
Haciendo Magia: Construyendo un Marco de Trabajo Primero-TypeScript
TypeScript Congress 2023TypeScript Congress 2023
31 min
Haciendo Magia: Construyendo un Marco de Trabajo Primero-TypeScript
Top Content
Daniel Rowe discusses building a TypeScript-first framework at TypeScript Congress and shares his involvement in various projects. Nuxt is a progressive framework built on Vue.js, aiming to reduce friction and distraction for developers. It leverages TypeScript for inference and aims to be the source of truth for projects. Nuxt provides type safety and extensibility through integration with TypeScript. Migrating to TypeScript offers long-term maintenance benefits and can uncover hidden bugs. Nuxt focuses on improving existing tools and finds inspiration in frameworks like TRPC.
Deja de Escribir tus Rutas
Vue.js London 2023Vue.js London 2023
30 min
Deja de Escribir tus Rutas
Designing APIs is a challenge, and it's important to consider the language used and different versions of the API. API ergonomics focus on ease of use and trade-offs. Routing is a misunderstood aspect of API design, and file-based routing can simplify it. Unplugging View Router provides typed routes and eliminates the need to pass routes when creating the router. Data loading and handling can be improved with data loaders and predictable routes. Handling protected routes and index and ID files are also discussed.
Compilaciones de TypeScript más rápidas con --isolatedDeclarations
TypeScript Congress 2023TypeScript Congress 2023
24 min
Compilaciones de TypeScript más rápidas con --isolatedDeclarations
Top Content
This talk discusses the performance issues in TypeScript builds and introduces a new feature called isolated declarations. By running the compiler in parallel and using isolated modules, significant performance gains can be achieved. Isolated declarations improve build speed, compatibility with other tools, and require developers to write types in code. This feature has the potential to further increase performance and may be available in TypeScript soon.
Aplicaciones React (+Native) full-stack y seguras con tRPC.io
React Advanced 2021React Advanced 2021
6 min
Aplicaciones React (+Native) full-stack y seguras con tRPC.io
Top Content
Alex introduces tRPC, a toolkit for making end-to-end type-safe APIs easily, with auto-completion of API endpoints and inferred data from backend to frontend. tRPC works the same way in React Native and can be adopted incrementally. The example showcases backend communication with a database using queries and validators, with types inferred to the frontend and data retrieval done using Prisma ORM.