A collaborative collection of university lecture notes, study materials, and practical exercises for the Security and Artificial Intelligence degree program at the University of Milan (UniMi).
The project aims to make educational resources freely accessible, well-organized, and easy to navigate, while encouraging knowledge sharing among students.
Disclaimer: This is an independent, student-maintained project. It is not officially affiliated with or endorsed by the University of Milan.
The repository is organized by language, subject area, and course.
Materials are organized in language directories and can be extended without changing the website build configuration:
| Language | Materials |
|---|---|
| 🇮🇹 Italian | Browse Italian materials |
| 🇬🇧 English | Browse English materials |
The project is currently being organized, and some directories do not contain notes yet.
SecAI-UniMi uses Quartz, a static site generator designed for publishing Obsidian Markdown notes.
The website is intended to provide:
- Full-text search.
- Navigation through subjects and courses.
- Interactive graph visualization.
- Backlinks between related topics.
- Mathematical formulas and syntax-highlighted code.
- Responsive layouts and dark mode.
Website: SecAI-UniMi Online
The website is under development. Availability and content may change during the initial setup.
You can also browse the source Markdown files directly on GitHub.
SecAI-UniMi/
├── README.md
├── CONTRIBUTING.md
├── LICENSE.md
├── .gitignore
│
├── materials/
│ ├── it/
│ │ ├── Architetture informatiche e Reti/
│ │ └── Matematica e Fondamenti di programmazione/
│ └── en/
│
└── .github/
├── quartz/
│ ├── quartz.config.yaml
│ └── prepare-content.mjs
└── workflows/
└── deploy-pages.yml
Each direct child of materials/ represents a language and must use a canonical BCP 47 language tag, such as it, en, fr, or pt-BR.
Each course may eventually include theoretical explanations, worked exercises, code examples, and supporting assets.
The notes are written in Markdown and designed to work with Obsidian.
To use the repository locally:
- Open the repository on GitHub.
- Select Code → Download ZIP.
- Extract the archive.
- Open Obsidian.
- Select Open folder as vault.
- Choose the extracted repository folder or the appropriate directory under
materials/.
You can read, search, annotate, and customize your downloaded copy of the notes.
Obsidian-specific features may not render identically in GitHub's Markdown preview.
Contributions from students are welcome!
You can help by:
- Adding new lecture notes.
- Improving or correcting explanations.
- Providing exercises and worked solutions.
- Translating content into additional languages.
- Fixing broken links and formatting issues.
- Reporting errors or proposing improvements.
- Fork the repository.
- Create a dedicated branch.
- Add or update the relevant material.
- Open a Pull Request targeting
main. - Wait for review and approval.
All contributions are subject to the repository's configured branch protection and review requirements.
Please read CONTRIBUTING.md before submitting changes.
Found an incorrect formula, unclear explanation, broken link, unreliable source, or missing topic?
Open an Issue and select the appropriate template.
You do not need programming experience or Git knowledge to report a problem. Every correction helps improve the study materials for everyone.
The documentation website is generated using Quartz 5 and published through GitHub Actions and GitHub Pages.
Website configuration and content preparation scripts are maintained inside .github/quartz/. Quartz is checked out at the commit in .github/quartz/quartz-revision.txt. The tracked package manifest and lockfile include all plugins and the Minimal theme; CI installs them with npm ci.
- Node.js 22 or later.
- npm 10.9.2 or later.
From the repository root:
node .github/quartz/setup.mjs
cd tmp/quartz-build
npm ci
cd ../..
node .github/quartz/prepare-content.mjs --source materials --output tmp/quartz-build/content
cd tmp/quartz-build
node quartz/bootstrap-cli.mjs build
cd ../..
node .github/quartz/verify-output.mjs
cd tmp/quartz-build
node quartz/bootstrap-cli.mjs build --serveThe commands start the local Quartz preview using the content generated from materials/.
The build lives in tmp/quartz-build; an existing legacy site/ folder is left untouched. Setup can be repeated for the same pinned revision. To change revisions, first move the old build directory aside. The script checks the upstream scanning patch before applying it, so ignored generated content is still published.
Generated copies inherit creation/modification dates from the source Git history, while explicit frontmatter dates take precedence. ZIP downloads without Git history use filesystem dates.
Before uploading, CI checks HTML homepages, the search index and at least ten populated notes in each of the two existing courses. Update these expectations deliberately if the course structure changes.
When upgrading Quartz, update the pinned commit, reconcile the tracked package.json with upstream, regenerate package-lock.json including the theme and Excalidraw, then run the same clean install, build and verification steps.
The preparation script discovers every language under materials/, copies its content, creates missing language indexes, and generates the language links on the website homepage.
Create a directory under materials/ using its canonical BCP 47 language tag and add the translated notes there. For example:
materials/fr/
The next local or CI build will include /fr/ automatically. No workflow or Quartz configuration change is required.
The GitHub Actions workflow is designed to:
- Validate the Quartz build for pull requests.
- Build the documentation website after changes to
main. - Publish the generated static files to GitHub Pages.
Generated files and local dependencies should not be committed to the repository.
Unless otherwise indicated, the original educational content in this repository is licensed under Creative Commons Attribution-NonCommercial 4.0 International (CC BY-NC 4.0).
You may share, adapt, translate, and redistribute the licensed materials for non-commercial purposes, provided that you:
- Give appropriate credit to the original authors.
- Provide a reference to the license.
- Indicate any changes made.
- Respect the rights of third-party authors.
Commercial use, including selling the notes, is not permitted without separate permission from the relevant rights holders.
For more information, see LICENSE.md or the official CC BY-NC 4.0 license.
Third-party software and dependencies, including Quartz, may be distributed under separate licenses.
The materials in this repository are intended to support learning and revision.
They may contain errors, incomplete explanations, or outdated information. Always verify important concepts using official course resources and reliable references.
Do not use this project to violate university policies, examination rules, or intellectual property rights.
If you find SecAI-UniMi useful, consider starring the repository or sharing it with fellow students.
Contributions, corrections, and translations are always appreciated.
Made by students, for students.