Dokumentacja w pigułce
...
Co dzieje się podczas build?
System include
<!-- NetBundler.include("partials/header.html") -->
/// NetBundler.include("partials/header.html")
/** NetBundler.include("partials/header.html") */
/** NetBundler.include("partials/variables.css") */
/// NetBundler.include("modules/utils.js")
Include rozbija duże pliki na mniejsze fragmenty i skleja je przy buildzie. Includes split large files into smaller parts and assemble them during build.
Zasoby lokalne z @
<img src="@image.png">
background-image: url(@background.jpg);
NetBundler kopiuje zasób do katalogu wynikowego assets i przepisuje ścieżkę. NetBundler copies the asset into the output assets folder and rewrites the path.
Tryb live (watch)
Po włączeniu live: true bundler obserwuje źródła, assets oraz includowane pliki i przebudowuje projekt po zmianach. When live: true is enabled, the bundler watches sources, assets, and included files and rebuilds on changes.
FAQ
Najczęstsze problemy: brak zasobu @, błędna ścieżka include, cykl include, brak przebudowy w live. Most common issues: missing @ asset, wrong include path, include cycles, live mode not rebuilding.
Dobre praktyki
Trzymaj źródła w src, wynik w dist, rozbijaj pliki na partials i składaj include. Keep sources in src, publish from dist, split files into partials and assemble via includes.
Słowniczek
build, include, assets, live/watch, ścieżki względne i od „/”. build, include, assets, live/watch, relative and “/” root paths.