diff --git a/README.md b/README.md index 84c26cc..884a282 100644 --- a/README.md +++ b/README.md @@ -33,6 +33,10 @@ ## Intro +[![Built with Material for MkDocs](https://img.shields.io/badge/Material_for_MkDocs-526CFE?style=for-the-badge&logo=MaterialForMkDocs&logoColor=white)](https://squidfunk.github.io/mkdocs-material/) + +![Github Pages](https://img.shields.io/badge/github%20pages-121013?style=for-the-badge&logo=github&logoColor=white) +

\ No newline at end of file diff --git a/docs/meetup/archive/generative_ai/gen_ai_1.md b/docs/meetup/archive/generative_ai/gen_ai_1.md new file mode 100644 index 0000000..d907da2 --- /dev/null +++ b/docs/meetup/archive/generative_ai/gen_ai_1.md @@ -0,0 +1,27 @@ +--- +title: Alla scoperta dei Large Language Model +disquis: PythonBiellaGroup +tags: + - LLM +--- + +## Intro + +In questo incontro abbiamo parlato di Generative AI con un professionista di [Data Masters](https://datamasters.it/), Giuseppe Mastrandrea, che ci ha guidato tra teoria e pratica alla scoperta dei LLM. + +I temi trattati sono: + +* Introduzione alle generative AI e agli LLM +* Focus su spazi latenti, layer di embedding e loro addestramento +* Cenni e primi esperimenti con agenti "custom", ovvero creati da noi + +## Materiale + +| | Link | +|----------|----------| +| Slides | [![Github](https://img.shields.io/badge/GitHub-181717.svg?style=for-the-badge&logo=GitHub&logoColor=white)](https://github.com/PythonBiellaGroup/MaterialeSerate/blob/master/GenerativeAI/GenerativeAI_slides_01.pdf) | +| Notebook | [![Open In Collab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/drive/1xIwMqN7JmBsheAEDKQ3CJWxPmzAfrC-Y?usp=sharing) | +| LangChain | https://python.langchain.com/docs/get_started/introduction | + +## Video del meetup + \ No newline at end of file diff --git a/docs/meetup/archive/generative_ai/gen_ai_2.en.md b/docs/meetup/archive/generative_ai/gen_ai_2.en.md new file mode 100644 index 0000000..efd65b7 --- /dev/null +++ b/docs/meetup/archive/generative_ai/gen_ai_2.en.md @@ -0,0 +1,29 @@ +--- +title: Building an intelligent agent with LangChain, Gradio, and OpenAI +disquis: PythonBiellaGroup +tags: + - LLM +--- + +## Intro + +In this second meeting dedicated to Generative AI, Vincenzo Maritati, a professional from [Data Masters](https://datamasters.it/), guided us through theory and practice in building our own intelligent agent using LangChain, Gradio, and OpenAI. + +The topics covered during the session were: + +* LangChain framework +* Sequential Memory +* Prompt Template +* Analysis of the demo code + +## Material + + +| | Link | +|----------|----------| +| Slides | [![Github](https://img.shields.io/badge/GitHub-181717.svg?style=for-the-badge&logo=GitHub&logoColor=white)](https://github.com/PythonBiellaGroup/MaterialeSerate/blob/master/GenerativeAI/GenerativeAI_slides_02.pdf) | +| Code | [![Github](https://img.shields.io/badge/GitHub-181717.svg?style=for-the-badge&logo=GitHub&logoColor=white)](https://github.com/PythonBiellaGroup/MaterialeSerate/tree/master/GenerativeAI/Serata%2002) | + + +## Meetup video + \ No newline at end of file diff --git a/docs/meetup/archive/generative_ai/gen_ai_2.md b/docs/meetup/archive/generative_ai/gen_ai_2.md new file mode 100644 index 0000000..8f9b0fc --- /dev/null +++ b/docs/meetup/archive/generative_ai/gen_ai_2.md @@ -0,0 +1,28 @@ +--- +title: Come costruire un agente intelligente con LangChain, gradio e OpenAI +disquis: PythonBiellaGroup +tags: + - LLM +--- + +## Intro + +In questo secondo incontro dedicato alla Generative AI, Vincenzo Maritati, professionista di [Data Masters](https://datamasters.it/), ci ha guidato tra teoria e pratica attraverso la costruzione di un proprio agente intelligente sfruttando LangChain, gradio e OpenAi. + +I temi trattati durante la serata sono stati: + +* LangChain framework +* Memoria Sequenziale +* Prompt Template +* Analisi del codice della demo + +## Materiale + +| | Link | +|----------|----------| +| Slides | [![Github](https://img.shields.io/badge/GitHub-181717.svg?style=for-the-badge&logo=GitHub&logoColor=white)](https://github.com/PythonBiellaGroup/MaterialeSerate/blob/master/GenerativeAI/GenerativeAI_slides_02.pdf) | +| Code | [![Github](https://img.shields.io/badge/GitHub-181717.svg?style=for-the-badge&logo=GitHub&logoColor=white)](https://github.com/PythonBiellaGroup/MaterialeSerate/tree/master/GenerativeAI/Serata%2002) | + + +## Video del meetup + \ No newline at end of file diff --git a/docs/meetup/archive/generative_ai/index.en.md b/docs/meetup/archive/generative_ai/index.en.md new file mode 100644 index 0000000..3cbff57 --- /dev/null +++ b/docs/meetup/archive/generative_ai/index.en.md @@ -0,0 +1,19 @@ +--- +title: Generative AI +disquis: PythonBiellaGroup +--- + +## Intro + +Here is our two-part series dedicated to exploring Generative AI and Large Language Models (LLM). This series will take you through the fundamental concepts and practical applications of these cutting-edge technologies in the field of artificial intelligence. + +The series is curated by [Data Masters](https://datamasters.it/). + +## Structure of the series + +1. Introduction to the world of Generative AI and LLM +2. Building an intelligent agent with LangChain, Gradio, and OpenAI + +## Material + +[![Github](https://img.shields.io/badge/GitHub-181717.svg?style=for-the-badge&logo=GitHub&logoColor=white)](https://github.com/PythonBiellaGroup/MaterialeSerate/tree/master/GenerativeAI) \ No newline at end of file diff --git a/docs/meetup/archive/generative_ai/index.md b/docs/meetup/archive/generative_ai/index.md new file mode 100644 index 0000000..6d66d95 --- /dev/null +++ b/docs/meetup/archive/generative_ai/index.md @@ -0,0 +1,19 @@ +--- +title: Generative AI +disquis: PythonBiellaGroup +--- + +## Introduzione + +Ecco il nostro percorso di due incontri dedicati all'esplorazione delle Generative AI e dei Large Language Models (LLM). Questo percorso vi condurrà attraverso i concetti fondamentali e le applicazioni pratiche di queste tecnologie all'avanguardia nell'ambito dell'intelligenza artificiale. + +Il percorso é a cura di [Data Masters](https://datamasters.it/). + +## Struttura del percorso + +1. Introduzione al mondo delle generative AI e ai LLM +2. Come costruire un agente intelligente con LangChain, gradio e OpenAI + +## Materiale + +[![Github](https://img.shields.io/badge/GitHub-181717.svg?style=for-the-badge&logo=GitHub&logoColor=white)](https://github.com/PythonBiellaGroup/MaterialeSerate/tree/master/GenerativeAI) \ No newline at end of file diff --git a/docs/meetup/archive/intro_micropython/index.en.md b/docs/meetup/archive/intro_micropython/index.en.md new file mode 100644 index 0000000..20cce03 --- /dev/null +++ b/docs/meetup/archive/intro_micropython/index.en.md @@ -0,0 +1,22 @@ +--- +title: Introduction to micropython +disquis: PythonBiellaGroup +--- + +## Intro + +MicroPython is a compact and optimized version of Python, designed to run on microcontrollers and embedded devices. It offers a complete and standard-compliant Python implementation on devices with limited resources, such as ARM Cortex-M microcontrollers. + +MicroPython has become popular among makers because it allows them to write Python code to control and interact with their electronic devices in a simpler and more intuitive way compared to other more complex programming languages. + +This series is curated by [Juna Salviati](https://www.linkedin.com/in/junasalviati/). + +## Structure of the series + +1. Introduction to the Maker World +2. IoT, Cloud, and Examples using MicroPython + +## Material + +[![Github](https://img.shields.io/badge/GitHub-181717.svg?style=for-the-badge&logo=GitHub&logoColor=white)](https://github.com/PythonBiellaGroup/MaterialeSerate/tree/master/MicroPython) + diff --git a/docs/meetup/archive/intro_micropython/index.md b/docs/meetup/archive/intro_micropython/index.md new file mode 100644 index 0000000..4a1304f --- /dev/null +++ b/docs/meetup/archive/intro_micropython/index.md @@ -0,0 +1,22 @@ +--- +title: Introduzione a micropython +disquis: PythonBiellaGroup +--- + +## Introduzione + +MicroPython è una versione compatta e ottimizzata di Python, progettata per funzionare su microcontroller e dispositivi embedded. Offre un'implementazione Python completa e compatibile con lo standard su dispositivi con risorse limitate, come microcontrollori ARM Cortex-M. + +MicroPython è diventato popolare tra i maker perché consente loro di scrivere codice Python per controllare e interagire con i loro dispositivi elettronici in modo più semplice e intuitivo rispetto ad altri linguaggi di programmazione più complessi. + +La serie é a cura di [Juna Salviati](https://www.linkedin.com/in/junasalviati/). + +## Struttura del percorso + +1. Introduzione al mondo dei makers +2. Iot, cloud ed esempi utilizzando micropython + +## Materiale + +[![Github](https://img.shields.io/badge/GitHub-181717.svg?style=for-the-badge&logo=GitHub&logoColor=white)](https://github.com/PythonBiellaGroup/MaterialeSerate/tree/master/MicroPython) + diff --git a/docs/meetup/archive/intro_micropython/micropython_1.en.md b/docs/meetup/archive/intro_micropython/micropython_1.en.md new file mode 100644 index 0000000..fa69a25 --- /dev/null +++ b/docs/meetup/archive/intro_micropython/micropython_1.en.md @@ -0,0 +1,27 @@ +--- +title: Introduction to the makers world +disquis: PythonBiellaGroup +tags: + - micropython +--- + +## Intro + +MicroPython is a software implementation of the Python 3 programming language, written in C, optimized for running on microcontrollers. + +It's an excellent tool for programming electronic boards, microcontrollers, and realizing projects for makers! + +With [Juna Salviati](https://www.linkedin.com/in/junasalviati/), we delved into the world of electronics discussing: + +* IoT, Microcontrollers, and Boards +* Introduction to Electronics +* Building a Thermometer +* From Volts to Temperature +* A use case: crop growth prediction + +## Material + +[![Github](https://img.shields.io/badge/GitHub-181717.svg?style=for-the-badge&logo=GitHub&logoColor=white)](https://github.com/PythonBiellaGroup/MaterialeSerate/blob/master/MicroPython/MicroPython%2001%20-%20Introduzione%20al%20mondo%20dei%20makers.pdf) + +## Meetup video + \ No newline at end of file diff --git a/docs/meetup/archive/intro_micropython/micropython_1.md b/docs/meetup/archive/intro_micropython/micropython_1.md new file mode 100644 index 0000000..9570f38 --- /dev/null +++ b/docs/meetup/archive/intro_micropython/micropython_1.md @@ -0,0 +1,27 @@ +--- +title: Introduzione al mondo dei makers +disquis: PythonBiellaGroup +tags: + - micropython +--- + +## Intro + +MicroPython è un'implementazione software del linguaggio di programmazione Python 3, scritto in C, ottimizzato per l'esecuzione su microcontrollori. + +È un ottimo strumento per programmare schede elettroniche, microcontrollori e realizzare progetti da "makers"! + +Con [Juna Salviati](https://www.linkedin.com/in/junasalviati/) ci siamo immersi nel mondo dell'elettronica parlando di: + +* IoT, Microcontrollori e Board +* Introduzione all'elettronica +* Costruiamo un termometro +* Dai Volt alla temperatura +* Un caso d'uso: predizione della crescita delle colture + +## Materiale + +[![Github](https://img.shields.io/badge/GitHub-181717.svg?style=for-the-badge&logo=GitHub&logoColor=white)](https://github.com/PythonBiellaGroup/MaterialeSerate/blob/master/MicroPython/MicroPython%2001%20-%20Introduzione%20al%20mondo%20dei%20makers.pdf) + +## Video del meetup + \ No newline at end of file diff --git a/docs/meetup/archive/intro_micropython/micropython_2.en.md b/docs/meetup/archive/intro_micropython/micropython_2.en.md new file mode 100644 index 0000000..c3605a7 --- /dev/null +++ b/docs/meetup/archive/intro_micropython/micropython_2.en.md @@ -0,0 +1,25 @@ +--- +title: IoT and Cloud +disquis: PythonBiellaGroup +tags: + - micropython +--- + +## Intro + +After the introductory session, this time we delve a bit deeper into the world of IoT and how to work in a cloud environment, of course together with [Juna Salviati](https://www.linkedin.com/in/junasalviati/). + +In particular, we covered: + +* Transition to the cloud: some Azure services for IoT +* Fundamental concepts of IoTCentral +* From simulated device to real device +* Code on the device (package managing) +* Using REST APIs (Python wrapper + Django app) + +## Material + +[![Github](https://img.shields.io/badge/GitHub-181717.svg?style=for-the-badge&logo=GitHub&logoColor=white)](https://github.com/PythonBiellaGroup/MaterialeSerate/blob/master/MicroPython/MicroPython%2002%20-%20MicroPython%20%26%20Iot%20in%20cloud.pdf) + +## Meetup video + \ No newline at end of file diff --git a/docs/meetup/archive/intro_micropython/micropython_2.md b/docs/meetup/archive/intro_micropython/micropython_2.md new file mode 100644 index 0000000..0defbdd --- /dev/null +++ b/docs/meetup/archive/intro_micropython/micropython_2.md @@ -0,0 +1,25 @@ +--- +title: Iot e Cloud +disquis: PythonBiellaGroup +tags: + - micropython +--- + +## Intro + +Dopo la prima serata introduttiva, questa volta andiamo un po' più nel dettaglio del mondo IoT e di come lavorare in ambiente cloud, ovviamente assieme a [Juna Salviati](https://www.linkedin.com/in/junasalviati/). + +In particolare abbiamo visto: + +* Passaggio al cloud: alcuni servizi Azure per l’IoT +* Concetti fondamentali di IoTCentral +* Dal device simulato al vero device +* Codice nel device (package managing) +* Usare le REST API (wrapper python+app Django) + +## Materiale + +[![Github](https://img.shields.io/badge/GitHub-181717.svg?style=for-the-badge&logo=GitHub&logoColor=white)](https://github.com/PythonBiellaGroup/MaterialeSerate/blob/master/MicroPython/MicroPython%2002%20-%20MicroPython%20%26%20Iot%20in%20cloud.pdf) + +## Video del meetup + \ No newline at end of file diff --git a/docs/meetup/archive/intro_polars/index.en.md b/docs/meetup/archive/intro_polars/index.en.md new file mode 100644 index 0000000..40666fe --- /dev/null +++ b/docs/meetup/archive/intro_polars/index.en.md @@ -0,0 +1,20 @@ +--- +title: Introduction to Polars +disquis: PythonBiellaGroup +--- + +## Intro + +In this series of meetings, we will embark on a journey to discover Polars, one of the most important and high-performing libraries for working with data, particularly with dataframes. +The series is curated by [Luca Baggi](https://www.linkedin.com/in/lucabaggi/?originalSubdomain=it), the main contributor to the open-source library [functime](https://github.com/functime-org/functime). + +## Structure of the series + +1. Introduction to Polars with basic concepts +2. Polars and data manipulation +3. Polars: exploring functime + +## Material + +[![Github](https://img.shields.io/badge/GitHub-181717.svg?style=for-the-badge&logo=GitHub&logoColor=white)](https://github.com/baggiponte/polars-katas) + diff --git a/docs/meetup/archive/intro_polars/index.md b/docs/meetup/archive/intro_polars/index.md new file mode 100644 index 0000000..df2699d --- /dev/null +++ b/docs/meetup/archive/intro_polars/index.md @@ -0,0 +1,20 @@ +--- +title: Introduzione a Polars +disquis: PythonBiellaGroup +--- + +## Introduzione + +In questa serie di incontri partiremo alla scoperta di polars, una delle librerie più importanti e performanti per lavorare con i dati ed in particolare con i dataframe. +La serie é a cura di [Luca Baggi](https://www.linkedin.com/in/lucabaggi/?originalSubdomain=it), main contributor della libreria open source [functime](https://github.com/functime-org/functime). + +## Struttura del percorso + +1. Introduzione a Polars con concetti base +2. Polars e la manipolazione dei dati +3. Polars: alla scoperta di functime + +## Materiale + +[![Github](https://img.shields.io/badge/GitHub-181717.svg?style=for-the-badge&logo=GitHub&logoColor=white)](https://github.com/baggiponte/polars-katas) + diff --git a/docs/meetup/archive/intro_polars/intro_polars_1.en.md b/docs/meetup/archive/intro_polars/intro_polars_1.en.md new file mode 100644 index 0000000..b5f6485 --- /dev/null +++ b/docs/meetup/archive/intro_polars/intro_polars_1.en.md @@ -0,0 +1,23 @@ +--- +title: Introduction to Polars +disquis: PythonBiellaGroup +tags: + - polars +--- + +## Intro + +Polars is a library for data manipulation and processing, highly efficient and incredibly useful in the fields of Data Engineering and Data Science. But how does it really work? Together with [Luca Baggi](https://www.linkedin.com/in/lucabaggi/), we delved into the vast world of Polars, covering the following topics: + +* What is Apache Arrow +* Limitations of Pandas +* Why Polars is efficient +* How Polars works and how to use it +* Demonstrations of using Polars for specific tasks + +## Material + +[![Github](https://img.shields.io/badge/GitHub-181717.svg?style=for-the-badge&logo=GitHub&logoColor=white)](https://github.com/baggiponte/polars-katas) + +## Meetup video + \ No newline at end of file diff --git a/docs/meetup/archive/intro_polars/intro_polars_1.md b/docs/meetup/archive/intro_polars/intro_polars_1.md new file mode 100644 index 0000000..dffb412 --- /dev/null +++ b/docs/meetup/archive/intro_polars/intro_polars_1.md @@ -0,0 +1,25 @@ +--- +title: Introduzione a Polars +disquis: PythonBiellaGroup +tags: + - polars +--- + +## Intro + +Polars è una libreria per la manipolazione e il processamento dei dati, è molto efficiente e molto utile in ambito di Data Engineering e Data Science, ma come funziona davvero? +Assieme a [Luca Baggi](https://www.linkedin.com/in/lucabaggi/) abbiamo esplorato il vasto mondo di Polars toccando i seguenti argomenti: + +* Che cosa è Apache Arrow +* Limiti di Pandas +* Come mai Polars è efficiente +* Come funziona Polars e come si può usare +* Dimostrazioni di come usare polars per particolari task + +## Materiale + +[![Github](https://img.shields.io/badge/GitHub-181717.svg?style=for-the-badge&logo=GitHub&logoColor=white)](https://github.com/baggiponte/polars-katas) + +## Video del meetup + + \ No newline at end of file diff --git a/docs/meetup/archive/intro_polars/intro_polars_2.en.md b/docs/meetup/archive/intro_polars/intro_polars_2.en.md new file mode 100644 index 0000000..0465e45 --- /dev/null +++ b/docs/meetup/archive/intro_polars/intro_polars_2.en.md @@ -0,0 +1,26 @@ +--- +title: Data wrangling with Polars +disquis: PythonBiellaGroup +tags: + - polars +--- + +## Intro + +[Luca Baggi](https://www.linkedin.com/in/lucabaggi/) showcases how to write idiomatic code in Polars and maximize the performance of data transformation pipelines. + +Plenty of practical examples and a bit of live coding! + +* How to select columns and filter rows +* Aggregations and window functions +* Join, anti-join, and join-asof +* How to inspect query plans +* Efficient operations with nested data: lists and structs + +## Material + +[![Github](https://img.shields.io/badge/GitHub-181717.svg?style=for-the-badge&logo=GitHub&logoColor=white)](https://github.com/baggiponte/polars-katas) + +## Meetup video + + \ No newline at end of file diff --git a/docs/meetup/archive/intro_polars/intro_polars_2.md b/docs/meetup/archive/intro_polars/intro_polars_2.md new file mode 100644 index 0000000..97689d0 --- /dev/null +++ b/docs/meetup/archive/intro_polars/intro_polars_2.md @@ -0,0 +1,25 @@ +--- +title: Manipolazione dei dati con Polars +disquis: PythonBiellaGroup +tags: + - polars +--- + +## Intro + +[Luca Baggi](https://www.linkedin.com/in/lucabaggi/) ci mostra come scrivere codice idiomatico in Polars e massimizzare le prestazioni delle pipeline di trasformazione dati. +Moltissimi esempi pratici e un po' di live coding! + +* Come selezionare le colonne e filtrare le righe +* Aggregazioni e window functions +* Join, anti-join e join-asof +* Come ispezionare i query plan +* Operazioni efficienti con dati annidati: liste e struct + +## Materiale + +[![Github](https://img.shields.io/badge/GitHub-181717.svg?style=for-the-badge&logo=GitHub&logoColor=white)](https://github.com/baggiponte/polars-katas) + +## Video del meetup + + \ No newline at end of file diff --git a/docs/meetup/archive/intro_polars/polars_functime.en.md b/docs/meetup/archive/intro_polars/polars_functime.en.md new file mode 100644 index 0000000..0a05909 --- /dev/null +++ b/docs/meetup/archive/intro_polars/polars_functime.en.md @@ -0,0 +1,37 @@ +--- +title: Discover functime +disquis: PythonBiellaGroup +tags: + - polars + - time series +--- + +## Intro + +[Luca Baggi](https://www.linkedin.com/in/lucabaggi/) shows us how to perform time series forecasting, focusing particularly on the functime library. + +Here are the topics in detail: + +* A new, efficiency-based forecasting process + +* What is global forecasting? + +* How to use Polars for feature engineering + +* Introduction to functime (forecasting workflow) + +* Cross Validation (backtesting) + +* Tools for visualizing dozens of time series + +* Estimating confidence intervals + +* Hyperparameter tuning + +## Material + +[![Github](https://img.shields.io/badge/GitHub-181717.svg?style=for-the-badge&logo=GitHub&logoColor=white)](https://github.com/functime-org/functime) + +## Meetup video + + \ No newline at end of file diff --git a/docs/meetup/archive/intro_polars/polars_functime.md b/docs/meetup/archive/intro_polars/polars_functime.md new file mode 100644 index 0000000..536a3d2 --- /dev/null +++ b/docs/meetup/archive/intro_polars/polars_functime.md @@ -0,0 +1,37 @@ +--- +title: Alla scoperta di functime +disquis: PythonBiellaGroup +tags: + - polars + - time series +--- + +## Intro + +[Luca Baggi](https://www.linkedin.com/in/lucabaggi/) ci mostra come fare forecasting di serie storiche ed in particolare vedremo nel dettaglio la libreria functime. + +Ecco in dettaglio gli argomenti: + +* Un nuovo processo di forecasting basato sull'efficienza + +* Che cosa è il global forecasting? + +* Come usare Polars per feature engineering + +* Introduzione a functime (forecasting workflow) + +* Cross Validation (backtesting) + +* Strumenti per visualizzare decine di time series + +* Stimare intervalli di confidenza + +* Hyperparameter tuning + +## Materiale + +[![Github](https://img.shields.io/badge/GitHub-181717.svg?style=for-the-badge&logo=GitHub&logoColor=white)](https://github.com/functime-org/functime) + +## Video del meetup + + \ No newline at end of file diff --git a/docs/meetup/archive/mkdocs/index.en.md b/docs/meetup/archive/mkdocs/index.en.md new file mode 100644 index 0000000..e46adc0 --- /dev/null +++ b/docs/meetup/archive/mkdocs/index.en.md @@ -0,0 +1,28 @@ +--- +title: Mkdocs tutorial +disquis: PythonBiellaGroup +--- + +## Intro + +In this two-part series, we present MkDocs. + +MkDocs is a static website generator, primarily designed for creating documentation using Markdown files. Markdown is a readable markup language that allows you to format text simply using a straightforward and intuitive syntax. + +MkDocs greatly simplifies the process of creating and managing documentation, allowing users to focus on content without worrying about the complexity of creating HTML pages or managing layouts. With MkDocs, you can organize documentation in a structure of folders and Markdown files, which will then be automatically converted into HTML pages ready for publication. + +The series is curated by [Andrea Guzzo](https://www.linkedin.com/in/andreaguzzo/) and [Davide Airaghi](https://www.linkedin.com/in/airaghidavide/) + +!!! note "" + + Questo sito é stato costruito interamente con mkdocs e il tema mkdocs material. L'hosting del sito e il deploy é stato reso possibile grazie a github pages e github actions. + +## Structure of the series + +1. Main elements of mkdocs +2. Extra, plugins and site deployment + +## Material + +[![Github](https://img.shields.io/badge/GitHub-181717.svg?style=for-the-badge&logo=GitHub&logoColor=white)](https://github.com/PythonBiellaGroup/mkdocs-tutorial) + diff --git a/docs/meetup/archive/mkdocs/index.md b/docs/meetup/archive/mkdocs/index.md new file mode 100644 index 0000000..30ff0eb --- /dev/null +++ b/docs/meetup/archive/mkdocs/index.md @@ -0,0 +1,26 @@ +--- +title: Mkdocs tutorial +disquis: PythonBiellaGroup +--- + +## Introduzione + +In questa serie di due incontri vi presentiamo MkDocs. + +MkDocs è un generatore di siti web statici, progettato principalmente per la creazione di documentazione utilizzando file Markdown. Markdown è un linguaggio di markup leggibile che consente di formattare il testo in modo semplice utilizzando una sintassi semplice e intuitiva. + +MkDocs semplifica notevolmente il processo di creazione e gestione della documentazione, consentendo agli utenti di concentrarsi sul contenuto senza doversi preoccupare della complessità della creazione di pagine HTML o della gestione dei layout. Utilizzando MkDocs, è possibile organizzare la documentazione in una struttura di cartelle e file Markdown, che verranno quindi convertiti automaticamente in pagine HTML pronte per la pubblicazione. + +!!! note "" + + Questo sito é stato costruito interamente con mkdocs e il tema mkdocs material. L'hosting del sito e il deploy é stato reso possibile grazie a github pages e github actions. + +## Struttura del percorso + +1. Elementi principali di mkdocs +2. Extra, plugin e deploy del sito + +## Materiale + +[![Github](https://img.shields.io/badge/GitHub-181717.svg?style=for-the-badge&logo=GitHub&logoColor=white)](https://github.com/PythonBiellaGroup/mkdocs-tutorial) + diff --git a/docs/meetup/archive/mkdocs/tutorial_1.en.md b/docs/meetup/archive/mkdocs/tutorial_1.en.md new file mode 100644 index 0000000..5c0bc83 --- /dev/null +++ b/docs/meetup/archive/mkdocs/tutorial_1.en.md @@ -0,0 +1,28 @@ +--- +title: Main elements of mkdocs +disquis: PythonBiellaGroup +tags: + - mkdocs +--- + +## Intro + +In this first meeting, we will explore the fundamental aspects of MkDocs with particular attention to the **mkdocs material** theme, focusing on: + +* Initializing the project +* Basic elements to build your own site +* Mkdocs material and basic plugins + +## Material + +| | Link | +|----------|----------| +| Repo | [![Github](https://img.shields.io/badge/GitHub-181717.svg?style=for-the-badge&logo=GitHub&logoColor=white)](https://github.com/PythonBiellaGroup/mkdocs-tutorial) | +| Wiki | [PBG Learning](https://pythonbiellagroup.it/learning/mkdocs_tutorial/)| +| Mkdocs material | https://squidfunk.github.io/mkdocs-material/| +| Github pages | https://pages.github.com/| +| Github actions | https://docs.github.com/en/actions| + +## Meetup video + + \ No newline at end of file diff --git a/docs/meetup/archive/mkdocs/tutorial_1.md b/docs/meetup/archive/mkdocs/tutorial_1.md new file mode 100644 index 0000000..c4f8137 --- /dev/null +++ b/docs/meetup/archive/mkdocs/tutorial_1.md @@ -0,0 +1,28 @@ +--- +title: Elementi fondamentali di mkdocs +disquis: PythonBiellaGroup +tags: + - mkdocs +--- + +## Intro + +In questo primo incontro vedremo gli aspetti fondamentali di mkdocs con particolare attenzione al tema **mkdocs material** ed in particolare: + +* Inizializzare il progetto +* Elementi base per costruire il proprio sito +* Mkdocs material e plugin base + +## Materiale + +| | Link | +|----------|----------| +| Repo | [![Github](https://img.shields.io/badge/GitHub-181717.svg?style=for-the-badge&logo=GitHub&logoColor=white)](https://github.com/PythonBiellaGroup/mkdocs-tutorial) | +| Wiki | [PBG Learning](https://pythonbiellagroup.it/learning/mkdocs_tutorial/)| +| Mkdocs material | https://squidfunk.github.io/mkdocs-material/| +| Github pages | https://pages.github.com/| +| Github actions | https://docs.github.com/en/actions| + +## Video del meetup + + \ No newline at end of file diff --git a/docs/meetup/archive/mkdocs/tutorial_2.en.md b/docs/meetup/archive/mkdocs/tutorial_2.en.md new file mode 100644 index 0000000..22696ed --- /dev/null +++ b/docs/meetup/archive/mkdocs/tutorial_2.en.md @@ -0,0 +1,30 @@ +--- +title: Extra, plugins and site deployment +disquis: PythonBiellaGroup +tags: + - mkdocs +--- + +## Intro + +In this second meetup, we will learn the most advanced concepts of mkdocs and how to deploy your site using only open source tool. +Main topics: + +* Advanced concepts +* Extra components +* How to deploy a site built with MkDocs +* MkDocs vs Sphinx comparison + +## Material + +| | Link | +|----------|----------| +| Repo | [![Github](https://img.shields.io/badge/GitHub-181717.svg?style=for-the-badge&logo=GitHub&logoColor=white)](https://github.com/PythonBiellaGroup/mkdocs-tutorial) | +| Wiki | [PBG Learning](https://pythonbiellagroup.it/learning/mkdocs_tutorial/)| +| Mkdocs material | https://squidfunk.github.io/mkdocs-material/| +| Github pages | https://pages.github.com/| +| Github actions | https://docs.github.com/en/actions| + +## Meetup video + + \ No newline at end of file diff --git a/docs/meetup/archive/mkdocs/tutorial_2.md b/docs/meetup/archive/mkdocs/tutorial_2.md new file mode 100644 index 0000000..13c1a19 --- /dev/null +++ b/docs/meetup/archive/mkdocs/tutorial_2.md @@ -0,0 +1,29 @@ +--- +title: Extra, plugins e deploy del sito +disquis: PythonBiellaGroup +tags: + - mkdocs +--- + +## Intro + +In questo secondo incontro, impareremo i concetti più avanzati di mkdocs e come distribuire il tuo sito utilizzando solo strumenti open source. +Argomenti principali + +* Concetti avanzati +* Componenti extra +* Come distribuire un sito costruito con MkDocs +* Confronto tra MkDocs e Sphinx + +## Materiale + +| | Link | +|----------|----------| +| Repo | [![Github](https://img.shields.io/badge/GitHub-181717.svg?style=for-the-badge&logo=GitHub&logoColor=white)](https://github.com/PythonBiellaGroup/mkdocs-tutorial) | +| Wiki | [PBG Learning](https://pythonbiellagroup.it/learning/mkdocs_tutorial/)| +| Mkdocs material | https://squidfunk.github.io/mkdocs-material/| +| Github pages | https://pages.github.com/| +| Github actions | https://docs.github.com/en/actions| +## Video del meetup + + \ No newline at end of file diff --git a/docs/static/images/blog/new_brand_identity.jpeg b/docs/static/images/blog/new_brand_identity.jpeg new file mode 100644 index 0000000..f213418 Binary files /dev/null and b/docs/static/images/blog/new_brand_identity.jpeg differ diff --git a/docs/static/images/brand_identity/pbg_brand_identity.gif b/docs/static/images/brand_identity/pbg_brand_identity.gif new file mode 100644 index 0000000..d921cb1 Binary files /dev/null and b/docs/static/images/brand_identity/pbg_brand_identity.gif differ diff --git a/docs/static/images/supporters/gradient_logo.png b/docs/static/images/supporters/gradient_logo.png new file mode 100644 index 0000000..8504dca Binary files /dev/null and b/docs/static/images/supporters/gradient_logo.png differ diff --git a/docs/supporters/index.en.md b/docs/supporters/index.en.md index 30d0f64..9533ba9 100644 --- a/docs/supporters/index.en.md +++ b/docs/supporters/index.en.md @@ -40,6 +40,15 @@ Of course, the PythonBiellaGroup community always participates. Will we see you --- +### ✒️ **Gradient** + +![Image title](../static/images/supporters/gradient_logo.png) + +[Gradient](https://www.hypergradient.it/) is a design studio in Biella that specializes in creating the image and communication for significant brands and associations. They are the authors of the graphics of PythonBiellaGroup and have assisted us in creating our brand identity. + +--- + + ### 🎒 **TheRedCode** ![Image title](../static/images/supporters/theredcode_logo.png) diff --git a/docs/supporters/index.md b/docs/supporters/index.md index 4eeaa21..67a78e5 100644 --- a/docs/supporters/index.md +++ b/docs/supporters/index.md @@ -42,6 +42,15 @@ Ovviamente la community di PythonBiellaGroup partecipa sempre. Ci vediamo là? --- +### ✒️ **Gradient** + +![Image title](../static/images/supporters/gradient_logo.png) + +[Gradient](https://www.hypergradient.it/) é uno studio di design di Biella che si occupa di creare l'immagine e la comunicazione per importanti brand e associazioni. Sono gli autori delle grafiche di PythonBiellaGroup e ci hanno aiutato a realizzare la nostra brand identity. + +--- + + ### 🎒 **TheRedCode** ![Image title](../static/images/supporters/theredcode_logo.png) diff --git a/mkdocs.yml b/mkdocs.yml index 0fca49b..2da662e 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -17,6 +17,7 @@ nav: - index.md - board.md - community_history.md + - brand_identity.md - code_conduct.md - tags.md - Meetup: @@ -65,6 +66,10 @@ nav: - Profili, ruoli e blog: meetup/archive/flask/flask_8.md - Heroku e docker - deploy: meetup/archive/flask/flask_9.md - Rest API: meetup/archive/flask/flask_10.md + - Generative AI: + - meetup/archive/generative_ai/index.md + - Alla scoperta dei Large Language Model: meetup/archive/generative_ai/gen_ai_1.md + - Come costruire un agente intelligente: meetup/archive/generative_ai/gen_ai_2.md - Genropy: - meetup/archive/genropy/index.md - Intro, demo e primi passi: meetup/archive/genropy/genropy_1.md @@ -108,6 +113,14 @@ nav: - Libreria regex in python: meetup/archive/text_manipulation/text_2.md - Pipeline di analisi testo e Spacy: meetup/archive/text_manipulation/text_3.md - Un progetto di analisi e classificazione di testi con ML: meetup/archive/text_manipulation/text_4.md + - Micropython: + - meetup/archive/intro_micropython/index.md + - Introduzione al mondo dei makers: meetup/archive/intro_micropython/micropython_1.md + - IoT e cloud: meetup/archive/intro_micropython/micropython_2.md + - MkDocs: + - meetup/archive/mkdocs/index.md + - Elementi principali di mkdocs: meetup/archive/mkdocs/tutorial_1.md + - Extra, plugins e deploy del sito: meetup/archive/mkdocs/tutorial_2.md - Modern data engineering: - meetup/archive/modern_data_eng/index.md - Stato dell'arte e Apache Airflow: meetup/archive/modern_data_eng/modern_de_1.md @@ -145,6 +158,11 @@ nav: - Strumenti per la visualizzazione dei dati: meetup/archive/data_track/data_track_2.md - Strumenti per l'ingegnerizzazione dei dati: meetup/archive/data_track/data_track_3.md - Strumenti per il passaggio in produzione: meetup/archive/data_track/data_track_4.md + - Polars: + - meetup/archive/intro_polars/index.md + - Introduzione a Polars: meetup/archive/intro_polars/intro_polars_1.md + - Manipolazione dei dati con Polars: meetup/archive/intro_polars/intro_polars_2.md + - Alla scoperta di functime: meetup/archive/intro_polars/polars_functime.md - Pygame: - meetup/archive/pygame/index.md - Intro a pygame: meetup/archive/pygame/pygame_1.md @@ -256,6 +274,8 @@ nav: - learning/testing_python/resources/snippet.md - learning/testing_python/resources/talk.md - VS Code: learning/vscode/index.md + - Blog: + - blog/index.md - Supporters: - supporters/index.md - Speakers: @@ -269,6 +289,7 @@ theme: name: material docs_dir: docs site_dir: site + custom_dir: overrides extra_css: - style/custom.css extra_javascript: @@ -302,14 +323,14 @@ theme: text: Helvetica code: Roboto mono palette: - # Light mode + # Light mode - scheme: default primary: black accent: black toggle: icon: material/toggle-switch name: Switch to dark mode - # Dark mode + # Dark mode - scheme: slate primary: white accent: white @@ -360,6 +381,14 @@ markdown_extensions: plugins: - macros + - git-authors + - blogging: + dirs: + - blog + features: + tags: {} + theme: + name: card - timetoread: allPages: false - minify: @@ -496,7 +525,7 @@ plugins: Testing - Pytest e unittest: Testing - Pytest and unittest Testing - Doctest e behave: Testing - Doctest and behave - # learning + # learning Better code: Better code Creare un pacchetto: Create a package Data analysis: Data analysis @@ -511,15 +540,16 @@ plugins: Gestione delle configurazioni: Manage configurations Indipendenza tecnologica: Tech independence Risorse: Resources - + Introduzione a Polars: Introduction to Polars + Manipolazione dei dati con Polars: Data wrangling with Polars + Alla scoperta di functime: Discover functime + Introduzione al mondo dei makers: Introduction to the makers world + Iot e Cloud: Iot and Cloud + Alla scoperta dei Large Language Model: Discovering large language model + Come costruire un agente intelligente: Building an intelligent agent with LangChain, Gradio, and OpenAI + Elementi principali di mkdocs: Main elements of mkdocs + Extra, plugins e deploy del sito: Extra, plugins and site deployment - git-revision-date-localized -# - rss: -# match_path: blog/posts/.* -# date_from_meta: -# as_creation: date -# categories: -# - categories -# - tags #Extra material theme settings extra: diff --git a/overrides/partials/comments.html b/overrides/partials/comments.html new file mode 100644 index 0000000..f5535bc --- /dev/null +++ b/overrides/partials/comments.html @@ -0,0 +1,54 @@ +{% if page.meta.comments %} +

{{ lang.t("meta.comments") }}

+ + + + + +{% endif %} \ No newline at end of file diff --git a/poetry.lock b/poetry.lock index 008bdad..5e9dc02 100644 --- a/poetry.lock +++ b/poetry.lock @@ -840,6 +840,47 @@ type = "legacy" url = "https://pypi.org/simple" reference = "pypi.org" +[[package]] +name = "mkdocs-blogging-plugin" +version = "2.2.11" +description = "Mkdocs plugin that generates a blog index page sorted by creation date." +optional = false +python-versions = ">=3.6" +files = [ + {file = "mkdocs-blogging-plugin-2.2.11.tar.gz", hash = "sha256:91b3ebc1ee3870958a0f9304d985f73a8e170a1f8d17948488415fa1a4257b2e"}, + {file = "mkdocs_blogging_plugin-2.2.11-py3-none-any.whl", hash = "sha256:7e0f14e5a5d9d7fa106ee014b04a49e2fdb5ffe70a0026106dceb79930ba8ac2"}, +] + +[package.dependencies] +babel = ">=2.7.0" +GitPython = ">=3.1.18" +jinja2 = ">=2" +mkdocs = ">=1.0" + +[package.source] +type = "legacy" +url = "https://pypi.org/simple" +reference = "pypi.org" + +[[package]] +name = "mkdocs-git-authors-plugin" +version = "0.7.2" +description = "Mkdocs plugin to display git authors of a page" +optional = false +python-versions = ">=3.7" +files = [ + {file = "mkdocs-git-authors-plugin-0.7.2.tar.gz", hash = "sha256:f541730e4cabdafa0ac758c94d28ba5e8ddca4c859e5de4c89f1226cb6ccd0ad"}, + {file = "mkdocs_git_authors_plugin-0.7.2-py3-none-any.whl", hash = "sha256:c8a2784a867db79ad3b477a96ee96875d17b09192b6d3be71f08df25afff76c4"}, +] + +[package.dependencies] +mkdocs = ">=1.0" + +[package.source] +type = "legacy" +url = "https://pypi.org/simple" +reference = "pypi.org" + [[package]] name = "mkdocs-git-revision-date-localized-plugin" version = "1.2.2" @@ -2227,4 +2268,4 @@ reference = "pypi.org" [metadata] lock-version = "2.0" python-versions = ">=3.9, !=3.9.7, <3.11" -content-hash = "46aa5ce8c4052e3471fe129d7a14707580f35d6b7732ed324d8b314a8de16700" +content-hash = "06481cab04a49e1aa9219bedeb9277859e8ed8f01690efb26afd2b21c7b946f0" diff --git a/pyproject.toml b/pyproject.toml index b52da4d..6e4bd2a 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -18,6 +18,8 @@ python = ">=3.9, !=3.9.7, <3.11" mkdocs = ">=1.5.3" mkdocs-autorefs = ">=0.5.0" mkdocs-awesome-pages-plugin = ">=2.9.2" +mkdocs-blogging-plugin = "^2.2.11" +mkdocs-git-authors-plugin = "^0.7.2" mkdocs-git-revision-date-localized-plugin = ">=1.2.0" mkdocs-macros-plugin = ">=1.0.4" mkdocs-material = ">=9.4.7"