Skip to content

About

Community-driven lecture notes, study materials and exercises for Security and Artificial Intelligence at the University of Milan (UniMi).

Topics

Resources

Contributing

Stars

8 stars

Watchers

1 watching

Forks

Latest commit

 

History

31 Commits

Folders and files

Repository files navigation

SecAI-UniMi

Security and Artificial Intelligence — University of Milan

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.


📚 Study Materials

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.

🌐 Online Documentation

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.

🗂️ Repository Structure

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.

🧠 Using the Notes with Obsidian

The notes are written in Markdown and designed to work with Obsidian.

To use the repository locally:

  1. Open the repository on GitHub.
  2. Select Code → Download ZIP.
  3. Extract the archive.
  4. Open Obsidian.
  5. Select Open folder as vault.
  6. 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.

🤝 Contributing

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.

Contribution Workflow

  1. Fork the repository.
  2. Create a dedicated branch.
  3. Add or update the relevant material.
  4. Open a Pull Request targeting main.
  5. 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.

Report an Issue

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.

🔧 Website Development

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.

Requirements

  • Node.js 22 or later.
  • npm 10.9.2 or later.

Local Development (Optional)

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 --serve

The 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.

Adding a Language

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.

Automatic Deployment

The GitHub Actions workflow is designed to:

  1. Validate the Quartz build for pull requests.
  2. Build the documentation website after changes to main.
  3. Publish the generated static files to GitHub Pages.

Generated files and local dependencies should not be committed to the repository.

⚖️ License

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.

📌 Academic Integrity

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.


⭐ Support the Project

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.

About

Community-driven lecture notes, study materials and exercises for Security and Artificial Intelligence at the University of Milan (UniMi).

Topics

Resources

Contributing

Stars

8 stars

Watchers

1 watching

Forks

Used by

Contributors