Assetgen er ment som en erstatning for de ulike ad-hoc skript som ofte blir skrevet for å bygge / administrere Javascript / CSS-filer.
Verktøyet er drevet av konfigurasjonen du angir i en assetgen.yaml fil, for eksempel
# Eksempel assetgen.yaml konfigurasjon
dannes:
- JS / base.js:
& Nbsp; kilde:
& Nbsp; -% (AMPIFY_ROOT) s / third_party / jslibs / json.js
- Js / app.js:
& Nbsp; kilde:
& nbsp; - statisk / js / Models.coffee
& nbsp; - statisk / js / Views.coffee
& nbsp; - statisk / js / Maps.coffee
& Nbsp; uglify:
& Nbsp; - --define-fra-modul
& Nbsp; - consts
& Nbsp; profile.dev:
& Nbsp; uglify:
& Nbsp; - --define-fra-modul
& Nbsp; - consts-dev
- Gfx / *:
& Nbsp; kilde: statisk / gfx / *
& Nbsp; Type: binær
- Css / site.css:
& Nbsp; kilde:
& Nbsp; - rå: |
& Nbsp; // Public Domain (-) 2011 The Ampify Forfattere.
& Nbsp; // Se Ampify UNLICENSE filen for detaljer.
& Nbsp; - statisk / css / site.sass
& Nbsp; støtter:
& Nbsp; -. Statisk / css / * sass
& Nbsp; - statisk / gfx / *
& Nbsp; bidi: true
& Nbsp; embed.path.root: statisk
& Nbsp; embed.url.base: /.static/
prereqs:
- Statisk / js / consts.js:
& Nbsp; kilde: statisk / js / consts.coffee
& Nbsp; komprimert: false
- Statisk / js / consts-dev.js:
& Nbsp; kilde: statisk / js / consts-dev.coffee
& Nbsp; komprimert: false
env:
& nbsp; NODE_PATH.prefix: statisk / js
output.directory: AppEngine / statisk
output.hashed: true
output.manifest: AppEngine / assets.json
profile.dev:
& Nbsp; css.compressed: false
& Nbsp; js.compressed: false
Du kan selv styre hvilke config alternativer blir brukt ved å angi --profile parameter. Dette vil overstyre standardverdier med de verdiene som er spesifisert for den gitte profilen. Så, i eksempelet ovenfor, vil spesifisere --profile dev bruke alle profile.dev alternativer.
Og til slutt, kan du angi tilpassede behandlingsprogrammer for assetgen å ringe når du genererer en fil av en gitt type. For eksempel, for å overstyre den innebygde js handler med ett som bare lavere Vare all kildeinnholdet, lage ditt internnummer, f.eks kickass-extension.py:
klasse KickassAsset (Asset):
& Nbsp; def generere (egen-):
& Nbsp; content = '' .join (les (kilde) .lower () for kilde i self.sources)
& Nbsp; self.emit (self.path, innhold)
register_handler ('js', KickassAsset)
Deretter kjører assetgen med --extension sti / til / kickass-extension.py parameter angitt.
Bruk
Bruk: assetgen [
Notat:
& Nbsp; Hvis du ikke angir assetgen.yaml filbaner, deretter `git
& Nbsp; LS-filer * assetgen.yaml` vil bli brukt til å oppdage alle config
& Nbsp; filer i gjeldende depotet. Så du må være inne
& Nbsp; en git repository arbeids treet.
Alternativer:
& Nbsp; h, help vis denne hjelpemeldingen og exit
& Nbsp; -V, --version viser programmets versjonsnummer og exit
& Nbsp; - clean fjerne alle genererte filer
& Nbsp; - debug satt debug-modus
& Nbsp; - extension = PATH angi en python forlengelse fil (kan gjentas)
& Nbsp; - force kraft gjenoppbygging av alle filer
& Nbsp; - profile = NAVN angi en profil for å bruke
& Nbsp; - se holde kjører assetgen på en sløyfe
Egenskaper
- Kompilering CoffeeScript kildefilene til Java
- Hvis du forminsker Java gjennom UglifyJS -., Inkludert den nye konstant folding støtte
- Kompilering og forminsker Sass stilark i CSS.
- Generering varianter av det samme stilarket for både internasjonalisering (blar venstre til høyre) og for automatisk innebygging bilder som data:. URIer for å minimere latency
- sette sammen flere kildefiler i én fil for å redusere antallet HTTP-forespørsler.
- Opprette forskjellige filer med hash av innholdet innebygd i filnavnet slik som å arbeide effektivt med web cacher.
- Opprette en JSON manifest fil for bruk i nett appens statiske handlers.
Krav
- Python
Kommentarer ikke funnet