Skip to content

kasiaizak/notatki

Repository files navigation

👋 Witaj na stronie dev.kasiaizak.pl

dev.kasiaizak.pl (dawniej Frontendowe notatki) to moje materiały zbierane podczas nauki frontendu 👩‍💻, a także podczas aktualnej pracy na stanowisku Junior Frontend Developera. 😁💪 Czemu w takiej formie? Wybrane narzędzie oferuje łatwą implementację kolorowania składni 🌈, na czym mi najbardziej zależało - screenshoty 📷 są przereklamowane - fajne, ale nie skopiujesz z nich łatwo kodu... 🤯 Gotowe serwisy oferujące podobną funkcjonalność mają swoje ograniczenia ⛔, a tu Wolność Tomku w swoim domku. 🤸‍♀️🏡 Z drugiej strony stworzenie tego projektu w oparciu o czysty HTML i CSS jest oczywiście możliwe, ale byłoby zdecydowanie bardziej pracochłonne 🙄, a chyba każdy się zgodzi, że nie o to chodzi przy robieniu notatek... 😏 Ma być szybko 🚀 i prosto 👶 - moim zdaniem cel został osiągnięty. 👌😍

A teraz parafrazując cytat prof. Jana Miodka o materiałach tu zawartych...

Teoria: jest wtedy, kiedy wiemy wszystko, a nic nie działa! 🧐⛔

Praktyka: jest wtedy, kiedy wszystko działa, a nikt nie wie dlaczego. 👌🤔

Tutaj łączę teorię z praktyką - nic nie działa i nikt nie wie dlaczego... 🤦‍♀️😱

🏠 Strona domowa

dev.kasiaizak.pl

🖥️ Instalacja lokalna

Projekt możesz w łatwy sposób postawić u siebie lokalnie klonując to repozytorium (jeśli korzystasz już z systemu kontroli wersji git):

git clone https://github.com/kasiaizak/notatki.git

lub po prostu pobierając paczkę ZIP z repozytorium:

Repo

🧐 Podgląd strony na żywo

Projekt ma wbudowaną funkcjonalność Podglądu na żywo, wymaga to jednak instalacji (najlepiej globalnie) pakietu docsify-cli. Niektóre edytory kodu oferują też taką funkcjonalność, np. Visual Studio Code + rozszerzenie Live Server, więc jeśli korzystasz z takiego rozwiązania, to możesz pominąć ten krok i przejść do kolejnej sekcji. 😉

By korzystać z pakietów npm potrzebny jest Node.js. Jeśli nie masz jeszcze zainstalowanego Node.js to nic straconego... 😄 Tu znajduje się instalka i można szybko to nadrobić: oficjalna strona Node.js.

npm i docsify-cli -g

Uruchamiając serwer lokalnie można podglądać zmiany strony na żywo pod adresem http://localhost:3000, by to zrobić wpisujemy w konsoli:

docsify serve

✏️ Edycja treści

  • index.html - plik wejściowy
  • README.md - strona główna
  • _sidebar.md - pasek boczny
  • _coverpage.md - strona tytułowa

🤝 Współtworzenie

  • Sforkuj repozytorium!
  • Utwórz swoją gałąź z nową funkcjonalnością: git checkout -b my-new-feature
  • Zakomentuj zmiany: git commit -m 'Add some feature'
  • Wypchnij je na gałąź: git push origin my-new-feature
  • Wyślij prośbę o wdrożenie zmian za pomocą Pull request.

Współtworzenie, zgłaszanie błędów i zapytania o nowe funkcjonalności są mile widziane!

🤔 Jak zacząć?

  • Jeśli szukasz miejsca do modyfikacji, sprawdź strukturę plików.
  • Jeśli chcesz dodać nowy plik, zrób to w odpowiedniej lokalizacji i dodaj również odniesienie w pliku _sidebar.md

👩‍💻 Autor - Kasia Izak

⭐️ Okaż swoje wsparcie

Zostaw ⭐️ przy repozytorium na GitHubie, jeśli ten projekt Ci się spodobał!

📝 Licencja

Copyright © Kasia Izak.

This project is MIT licensed.


To README zostało częściowo wygenerowane z ❤️ przez readme-md-generator

About

Beginner frontend developer notes :-)

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published