Toto je starší verze dokumentu!
Převod obrázků na Mrak
Mít obrázky v gitu není ze spoustu důvodů praktické. Samotný repozitář je velký a je problém ho stahovat, build jekyllu trvá dlouho a přechod na jiný buildovaci systém by byl náročný. I proto vzikla asset-server. Pojdme si povědět jak na něj převést weby.
Příprava
Najděte si kdo všechno dělá na tom webu a kontakty na ně napište jim co chystáte. Updatujte thema alepsopň na 7.7.0 (TODO ještě to bude chtít po fixu zvýšit)
Uklid - github
Na to aby jsme poznali, že jsme nic nesebrali budeme potřebovat nejdříve uklidit.
Jako první se podívame jestil někdo neodkazuje na github namísto /asstest/img a podobě pomocí grepu.
grep github -r -I --exclude-dir={_site,_people,vendor,.git,admin} --exclude={Gemfile,README.md,_config.yml,package.json}
Je třeba si dát i pozor na to že ne vždy se odkazuje na stené repo ve kterém jsem a některé odkazy na github mají důvod. Nicméně spousta z toho jde poloautomatizovaně opravit, nicméně vždy kontrolujte že nenaděláte více škody než užitku. Nezapomeňte si ověřit že dané soubory v assets existují.
Př.
URL=https://github.com/pirati-web/praha.pirati.cz/raw/gh-pages/assets/ grep $URL . -r -I --exclude-dir={_site,_people,vendor,.git,admin} --exclude {Gemfile,README.md,_config.yml,package.json} grep $URL . -r -I -l --exclude-dir={_site,_people,vendor,.git,admin} --exclude {Gemfile,README.md,_config.yml,package.json} > files.tmp for FILE in `cat files.tmp`; do sed -i "s,$URL,/assets/," $FILE ; done
git diff git commit -a -m "Oprava odkazu"
Uklid htmlproofer
používat htmlproofer. Jenže spousta webu má různj broken linky v sobě už teď je teda na začátku potřeba uklidit.
docker-compose up docker run -v $PWD/_site:/mounted-site 18fgsa/html-proofer /mounted-site --url-ignore https://github.com.* --internal-domains https://praha.pirati.cz
Jsou různé druhy chyb a je vhodné si to podle nich rozdělit a pro každou z nich si připravi automatizovatelný poustup. * odkaz jde na stránky třetích stran které už dávno nexistují - tam lze jít několika směry. Buť je uplně ignoravat nebo prozkoumat a zjistit jestli nemají náhradu jinde nebo to hodit na osobu starající se o obsah webu * odkaz vede na náš obrázek nebo url. V tom případě je dobré najít v jakém commitu byl ten odkaz přidán a podívat se na git v tom commitu a podle toho opravit. *
TODO návod je v příparvě
- Pusťte bundle exec htmlproofer –assume-extension ./_site a podívejte se na chyby
- opravte ty které můžete
- poznamenejte si zbytek ať je můžete v pozní fázi ignorovat
- Zkopírujte většinu obsahu složky assets do vaší složky na Mraku, ale pozor
- nekopírujete osložky css, js
- nekopírujte věci, které jsou nepouživáne
- tj začněte jen těmi o kterých víte že jsou potřeba a pak přidávejte další