https://github.com/viorelmocanu/digital-resources
A web-based version of the digital resources document found in https://bit.ly/vio-digital
https://github.com/viorelmocanu/digital-resources
List: digital-resources
astro astro3 awesome awesome-list css figma frontend html javascript learning list markdown resources sass scss
Last synced: 20 days ago
JSON representation
A web-based version of the digital resources document found in https://bit.ly/vio-digital
- Host: GitHub
- URL: https://github.com/viorelmocanu/digital-resources
- Owner: ViorelMocanu
- License: isc
- Created: 2022-10-09T18:50:26.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2025-03-09T23:47:48.000Z (11 months ago)
- Last Synced: 2025-04-11T14:18:00.345Z (9 months ago)
- Topics: astro, astro3, awesome, awesome-list, css, figma, frontend, html, javascript, learning, list, markdown, resources, sass, scss
- Language: Astro
- Homepage: https://resurse.dev/
- Size: 19 MB
- Stars: 37
- Watchers: 2
- Forks: 7
- Open Issues: 127
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
README
# Resurse digitale: **Resurse.dev**
[![GitHub Workflow Status][GitHub Workflow Shield]][GitHub Workflow Link] [![GitHub Pages Deploy Status][GitHub Pages Deploy Shield]][GitHub Pages Deploy Link] [![Uptime Robot status][Uptime Robot Shield]][Uptime Robot Link] [![GitHub contributors][GitHub contributors Shield]][GitHub contributors Link] [![GitHub Sponsors][GitHub Sponsors Shield]][GitHub Sponsors Link] [![ISC license][ISC license Shield]][ISC license Link] [![W3C Validation][W3C Validation Shield]][W3C Validation Link] [![Libraries.io dependency status for GitHub repo][Dependency status Badge]][Dependency Status Link] [![Project Stage Badge: Development][Project Stage Badge: Development]][Project Stage Link]
[//]: <> (Implement https://shields.io/badges/netlify once you deploy there)
Salutare!
Bine-ai venit în proiectul de _resurse digitale_, prin care transformăm link-urile din [Google Doc-ul făcut de mine acum mai mult timp] într-un website funcțional care să ajute oamenii să parcurgă resursele de învățare mai eficient.
Vezi toată seria de video-uri 🔴LIVE de pe YouTube în care am generat codul pentru acest proiect în [playlist-ul Resurse.dev de aici →].
Proiectul e abia la început, și dacă vrei să te implici, orice contribuție de-a ta este binevenită! Citește [regulile] și [ghidul despre cum să contribui] și ajută-ne să facem proiectul ăsta _cel mai bun loc din care să alegi ce resurse să folosești pentru învățare_! Contribuitorii majori vor fi menționați în [`humans.txt`].
Documentul curent este momentan în 🇷🇴 Română, însă cel mai probabil la finalul [v1.0] va fi bilingv (inclusiv în 🇬🇧 Engleză) pentru a stimula oameni din toate colțurile lumii să se alăture pentru a contribui la proiect și a semnala potențiale probleme. Restul documentației și task-urile din [GitHub Project-ul] unde poți vedea statusul tuturor issue-urilor create vor fi exclusiv în 🇬🇧 Engleză.
## Quick note in 🇬🇧 English
This project began in a 🇷🇴 Romanian community, so please excuse the almost entirely Romanian content in this `README.md` - we will translate this document in 🇬🇧 English by the end of [v1.0].
## ✅ Link-uri utile
1. [Lista de resurse generale] - 1600 link-uri pe care le transformăm din Google Docs în website (bonus: [Lista de resurse de JS pentru cine vrea să învețe Vue])
2. Design-ul [în Figma]
3. Inspirația [de design]
Ne-am mai inspirat de aici ca să facem proiectul curent:
- [Tutorial oficial al Astro 3.0]
- Componente: + + +
- [Integrări] din care vrem să testăm:
- [ ] `@astrojs/mdx`
- [x] `@astrojs/sitemap`
- [ ] `astro-compress` vs `astro-compressor` vs `astro-html-minifier`
- [ ] `astro-seo`
- [ ] `astro-seo-meta`
- [ ] `astro-seo-schema`
- [ ] `astro-robots-txt`
- [ ] `vite-plugin-pwa` + `astro-webmanifest`
- [x] `@astrojs/partytown`
- [ ] `astro-i18next`
- [x] `typescript` + `@typescript-eslint/eslint-plugin` + `@typescript-eslint/parser`
- [x] `eslint` + `eslint-plugin-astro` + `eslint-plugin-jsx-a11y`
- [x] `sass`
- [ ] `svgo`
- [ ] `@astro-community/astro-embed-youtube` + `@astro-community/astro-embed-twitter`
- [ ] `astro-purgecss`
- [ ] `@astrojs/vercel` vs `@astrojs/netlify` vs `@astrojs/cloudflare` vs `@astrojs/deno` pentru deploy
- [ ] `astro-icon` (optional) testat?
- [ ] `@sendgrid` (optional) pentru email?
- [ ] `accessible-astro-components` (optional) ca să „furăm” cod de aici?
- [ ] `@astrojs/tailwind` + `tailwindcss` (optional)
- [x] `prettier` + `prettier-plugin-astro` + `prettier-plugin-tailwindcss` (optional)
---
## 🕹️ Cum pornești proiectul?
Întâi, clonează repository-ul curent:
```bash
git clone https://github.com/ViorelMocanu/digital-resources.git
```
**BONUS:** dacă ești pe Winblows Windows, asigură-te că faci pașii următori într-o consolă cu drepturi de Administrator. Fie deschide VSCode sau IDE-ul tău preferat cu consolă atașată cu _`click dreapta > Run as Administrator`_ fie rulează `cmd.exe` sau `powershell.exe` cu drepturi de Admin.
Asigură-te că ai ultima versiune de Node instalată de pe [site-ul oficial Node.js]. Ideal e să ai minim versiunea `18.18.0`. Poți verifica versiunea instalată cu comanda:
```bash
node -v
```
Mai asigură-te că ai instalat și ultima variantă de PNPM, urmând [instrucțiunile de pe site-ul PNPM], sau rulează una din comenzile următoare.
Pentru Windows:
```bash
iwr https://get.pnpm.io/install.ps1 -useb | iex
```
Pentru POSIX / Mac / Linux / \*nix cu librăria `curl` disponibilă:
```bash
curl -fsSL https://get.pnpm.io/install.sh | sh -
```
Ideal e să ai minim versiunea de PNPM `8.8.0`. Poți verifica versiunea instalată cu comanda:
```bash
pnpm -v
```
Apoi, instalează dependințele din `package.json`:
```bash
pnpm install
```
Apoi, pornește proiectul local:
```bash
pnpm dev
```
Deschide browser-ul la adresa: ca să vezi proiectul rulând la tine local.
Dacă faci schimbări în arhitectura informațională din `./content` în special în `./content/config.ts` asigură-te că se re-construiește referința de **TypeScript** pentru conținut rulând:
```bash
pnpm astro sync
```
Dacă vrei să compilezi o variantă deployabilă a proiectului care generează toate rutele statice și fișierele necesare pentru deploy, rulează:
```bash
pnpm build
```
## 🧞 Comenzile disponibile
Toate comenzile sunt rulate din root-ul proiectului, dintr-un terminal:
| Command | Action |
| :--------------------- | :----------------------------------------------------------------------------------------- |
| `pnpm install` | Instalează dependințele |
| `pnpm dev` | Pornește serverul local de Astro la `localhost:4321` |
| `pnpm start` | Pornește serverul local de Astro la `localhost:4321` |
| `pnpm build` | Construiește site-ul de producție la `./dist/` |
| `pnpm preview` | Fă un preview al site-ului local înainte de deploy |
| `pnpm astro ...` | Rulează comenzi CLI cum ar fi `astro add`, `astro check` |
| `pnpm astro -- --help` | Afișează comenzile disponibile în Astro CLI |
| `pnpm format` | Validează codul local folosind `Prettier` și `prettier-plugin-astro` |
| `pnpm format:fix` | Validează și **corectează** codul folosind `Prettier` (atenție: poate fi distructiv) |
| `pnpm lint:js` | Validează fișierele JavaScript, TypeScript și Astro locale folosind `ESLint` |
| `pnpm lint:md` | Validează fișierele Markdown locale folosind `MarkdownLint` |
| `pnpm lint:fix` | Validează și **corectează** fișierele JavaScript, TypeScript și Markdown locale |
| `pnpm lint` | Validează fișierele JavaScript, TypeScript, Astro și Markdown cu `ESLint` / `MarkdownLint` |
| `pnpm typecheck` | Validează type-urile de TypeScript folosind TSC și `tsconfig.json` |
## 🛑 Semnalează un bug sau contribuie
     
Dacă ai observat un bug [ ](https://github.com/ViorelMocanu/digital-resources/labels/bug) și vrei să-l semnalezi, urmează documentația aferentă de aici: [CONTRIBUTING.md].
## 🚀 Structura proiectului
Înăuntrul proiectului Astro, vei vedea următoarele foldere și fișiere:
```text
/
├── public/
│ └── favicon.svg
├── src/
│ ├── components/
│ │ └── Header.astro
│ ├── layouts/
│ │ └── Layout.astro
│ └── pages/
│ └── index.astro
└── package.json
```
Astro caută fișiere cu extensia `.astro` sau `.md` în interiorul folder-ului `src/pages/` și le randează. Fiecare pagină este expusă ca o rută bazată pe numele fișierului.
Nu e nimic special cu folder-ul `src/components/`, doar că acolo ne punem în mod uzual componentele de tip Astro/React/Vue/Svelte/Preact.
Toate resursele statice în afară de imagini ar trebui puse în directorul `public/`, iar imaginile ar trebui puse în `src/img/` pentru a folosi [noile componente] `` și `` din Astro 3.0.
## 👋 Vrei să discuți cu noi?
Te așteptăm pe [server-ul de Discord], [canalul de YouTube] sau [grupul de Facebook] cu drag!
Pe serverul de Discord sunt: [](https://discord.com/invite/UpnAutz)
Pe canalul de YouTube am strâns până acum: [ ](https://www.youtube.com/@ViorelMocanu?sub_confirmation=1)
[](https://www.youtube.com/@ViorelMocanu) [](https://discord.com/invite/UpnAutz) [](https://www.facebook.com/groups/carierait) [](https://www.instagram.com/viorelmocanu.ro/) [](https://www.linkedin.com/in/viorelmocanu/) [](https://twitter.com/ViorelMocanu) [](https://viorelmocanu.ck.page/newsletter) [](https://www.viorelmocanu.ro/blog/)
## 💸 Sponsorizează inițiativa
Dacă simți că poți contribui financiar la această inițiativă, inclusiv să susții video-urile lui Viorel și materialele ajutătoare pe care le produce, îl poți sponsoriza aici:
[](https://github.com/sponsors/ViorelMocanu) [](https://www.patreon.com/ViorelMocanu) [](https://www.buymeacoffee.com/viorel)
Contribuțiile voastre vor ajuta la crearea de mai mult conținut pentru voi și la finalizarea mai rapidă a proiectului actual. Toți banii din investiții se întorc la comunitate, indirect, prin sprijinul acordat lui [Viorel](https://github.com/ViorelMocanu).
Merci! ❤️
[Viorel Mocanu], [Consultant digital] și [creator de conținut].
[Google Doc-ul făcut de mine acum mai mult timp]: https://bit.ly/vio-digital
[playlist-ul Resurse.dev de aici →]: https://youtube.com/playlist?list=PLfTqvIG4roBphVLnYuDTkfweQ2GmmcHOq
[regulile]: https://github.com/ViorelMocanu/digital-resources/blob/main/CODE_OF_CONDUCT.md
[ghidul despre cum să contribui]: https://github.com/ViorelMocanu/digital-resources/blob/main/CONTRIBUTING.md
[`humans.txt`]: https://github.com/ViorelMocanu/digital-resources/blob/main/humans.txt
[v1.0]: https://github.com/ViorelMocanu/digital-resources/milestone/1
[GitHub Project-ul]: https://github.com/users/ViorelMocanu/projects/2
[Lista de resurse generale]: https://bit.ly/vio-digital
[Lista de resurse de JS pentru cine vrea să învețe Vue]: https://bit.ly/vio-vue
[în Figma]: https://www.figma.com/file/FpXckvA4HYOJ1HIvsq62GS/Untitled?node-id=0%3A1
[de design]: https://www.behance.net/gallery/143657541/Female-Faces
[Tutorial oficial al Astro 3.0]: https://docs.astro.build/en/tutorial/0-introduction/
[Integrări]: https://astro.build/integrations/
[site-ul oficial Node.js]: https://nodejs.org/en
[instrucțiunile de pe site-ul PNPM]: https://pnpm.io/installation
[CONTRIBUTING.md]: https://github.com/ViorelMocanu/digital-resources/blob/main/CONTRIBUTING.md
[server-ul de Discord]: https://discord.com/invite/UpnAutz
[Viorel Mocanu]: https://github.com/ViorelMocanu
[Consultant digital]: https://www.viorelmocanu.ro/
[creator de conținut]: https://www.youtube.com/@ViorelMocanu
[noile componente]: https://docs.astro.build/en/guides/images/
[canalul de YouTube]: https://www.youtube.com/@ViorelMocanu
[grupul de Facebook]: https://www.facebook.com/groups/carierait
[Dependency Status Badge]: https://img.shields.io/librariesio/github/ViorelMocanu/digital-resources
[Dependency status Link]: https://github.com/ViorelMocanu/digital-resources/pulls
[GitHub Workflow Shield]: https://img.shields.io/github/actions/workflow/status/ViorelMocanu/digital-resources/static.yml
[GitHub Workflow Link]: https://github.com/ViorelMocanu/digital-resources/actions
[GitHub Pages Deploy Shield]: https://github.com/ViorelMocanu/digital-resources/actions/workflows/static.yml/badge.svg
[GitHub Pages Deploy Link]: https://github.com/ViorelMocanu/digital-resources/deployments
[Uptime Robot Shield]: https://img.shields.io/uptimerobot/status/m795450488-8340b637195100fd9eb8309b
[Uptime Robot Link]: https://resurse.dev
[GitHub contributors Shield]: https://img.shields.io/github/contributors/ViorelMocanu/digital-resources.svg
[GitHub contributors Link]: https://github.com/ViorelMocanu/digital-resources/graphs/contributors
[GitHub Sponsors Shield]: https://img.shields.io/github/sponsors/ViorelMocanu
[GitHub Sponsors Link]: https://github.com/sponsors/ViorelMocanu/
[ISC license Shield]: https://img.shields.io/badge/License-ISC-blue.svg?style=flat
[ISC license Link]: https://github.com/ViorelMocanu/digital-resources/blob/main/LICENSE
[W3C Validation Shield]: https://img.shields.io/w3c-validation/html?targetUrl=https%3A%2F%2Fresurse.dev
[W3C Validation Link]: https://validator.w3.org/nu/?doc=https%3A%2F%2Fresurse.dev%2F&showsource=yes&showoutline=yes
[Project Stage Link]: https://github.com/users/ViorelMocanu/projects/2/views/2
[Project Stage Badge: Development]: https://img.shields.io/badge/Project%20Stage-Development-yellowgreen.svg