{"id":13567842,"url":"https://github.com/kir-dev/blog-next","last_synced_at":"2025-04-04T02:33:33.914Z","repository":{"id":39179608,"uuid":"223392035","full_name":"kir-dev/blog-next","owner":"kir-dev","description":"📰 A Kir-Dev következő generációs blogja","archived":true,"fork":false,"pushed_at":"2023-11-14T10:31:22.000Z","size":65098,"stargazers_count":8,"open_issues_count":33,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-11-04T23:35:28.611Z","etag":null,"topics":["blog","gatsby","react","typescript","vercel"],"latest_commit_sha":null,"homepage":"https://kir-dev-blog-old.vercel.app/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kir-dev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-11-22T11:46:14.000Z","updated_at":"2024-02-22T22:24:31.000Z","dependencies_parsed_at":"2024-08-01T13:39:54.740Z","dependency_job_id":null,"html_url":"https://github.com/kir-dev/blog-next","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kir-dev%2Fblog-next","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kir-dev%2Fblog-next/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kir-dev%2Fblog-next/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kir-dev%2Fblog-next/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kir-dev","download_url":"https://codeload.github.com/kir-dev/blog-next/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247111804,"owners_count":20885498,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["blog","gatsby","react","typescript","vercel"],"created_at":"2024-08-01T13:02:45.642Z","updated_at":"2025-04-04T02:33:31.954Z","avatar_url":"https://github.com/kir-dev.png","language":"TypeScript","funding_links":[],"categories":["TypeScript"],"sub_categories":[],"readme":"# blog-next\n\n![Vercel](https://therealsujitk-vercel-badge.vercel.app/?app=blog-next-kir-dev\u0026style=for-the-badge)\n\nA [kir-dev.sch.bme.hu](https://kir-dev.sch.bme.hu) következő generációs blogja.\n\n## Telepítés\n\nLegyen telepítve [node.js](https://nodejs.org/en/) és [yarn v3](https://yarnpkg.com/getting-started/install) a gépeden. A gatsby-t szükséges globálisan feltelepíteni, ez a `npm i -g gatsby-cli` paranccsal tehető meg.\n\nHa az előkövetlemények megvannak, akkor\n\n    git clone https://github.com/kir-dev/blog-next.git kirdev-blog\n    cd kirdev-blog\n    yarn\n    yarn start\n\nA böngésződben pedig a `localhost:8000`-en tudod megnézni a blogot. A GraphiQL oldal a `localhost:8000/___graphql` címen lesz elérhető.\n\nA `.env.example` fájlt másold le, és nevezd át `.env.development`-re. Deploymentnél fontos a kiválasztott felhő platformon a környezeti változókat beállítani.\n\n## Készítenél posztot?\n\n1. Használd a `create-post.sh` shell scriptet (az `author` fieldnél érdemes a PéK-en is használt felhasználóneved megadni):\n\n```bash\n./create-post.sh '\u003ctitle\u003e' '\u003cauthor\u003e'\n```\n\nPélda: `./create-post.sh 'Heroku és társai' 'mypekusername'`\n\n2. Ezután keresd meg a posztod markdown fájlját.\n\n- Adj egy roppant rövid, maximum 6-7 szavas, 1 mondatos ízelítőt a posztról a `lead` field alatt (akár ki is hagyható).\n- A `featuredImage` fieldben megadhatsz egy képet, amelyet használnál a blogbejegyzésed previewjában, ezt a képed be is kell illesszed a `content/images/posts/` mappába. Ha nincs szükséged ilyenre, hagyd `null`-on.\n- A posztodnak lehetnek rövid tag-jei `tags` field alatt, de úgy, hogy értelme is legyen. Lehetőleg maradj max. 3 db rövid tag-nél. Pl.: `tags: ['hírek', 'média']`\n  - Ha rövid a poszt, és csak valami frissítést tartalmaz tagokról, jövőnkről, valami indulásáról --\u003e **hírek**\n  - Ha egy projektünkről szól --\u003e **projekt**\n  - Ha valami technológiairól --\u003e **tech**, **web** stb.\n  - Ha a körről közösségéről szól --\u003e **közösség**\n  - És így tovább (természetesen szabad kezed van ezekben).\n- Írd meg a posztot markdownban, **FONTOS:** képeket posztjaidba a [warp drive](https://warp.sch.bme.hu/)-on keresztül tegyél be. Jelentkezz be, készíts egy albumot, tedd be a képeket, és használd a 'copy to clipboard' gombot. Ha google képkeresőben vagy egy másik weboldalon találtál képet és azt illesztenéd be, először töltsd le a gépedre a kívánt képet, töltsd fel a warpra, majd onnan addresseld a képet. Így sosem vesznek el a képek, még ha a weboldal, ahonnan kölcsönveszed, megszüntetné a kép osztását.\n- Ha a posztnak saját og:image-et akarsz adni, azt is tedd a `content/images/posts/` mappába, majd adj hozzá egy `ogImage` fieldet a `featuredImage` alatt. Ha nem adsz meg, akkor a featuredImage lesz az og:image-e a posztnak. (ha egy kicsit lusta vagy og:image-et szerkeszteni, ajánlom a [Vercel og-image generatorát](https://github.com/vercel/og-image))\n\n3. Kérj review-t körtársaidtól egy pull requesten keresztül.\n\nNézz meg néhány korábbi blogposztot, hogy is tudod kihasználni a markdown adta lehetőségeket: code részletek beszúrása, képek beszúrása. Windows-on a create-post.sh shell scriptet tudod futtatni a Git bash-ben, ha már fel van telepítve a Git kliens.\n\nMi az indoka, hogy a `lead` rövid kell legyen, valamint a `tags` száma ne haladja meg a 3-at? Az olvasók szemét ritkán fogja meg egy-egy hosszabb szó, inkább a rövid hívószavaknak örülnek.\n\n## Készítenél oldalt egy projektnek?\n\nIgazából kövesd a fentieket, amit a posztkészítésnél kell, annyi, hogy a `create-project.sh` szkriptet használd.\n\n```bash\n./create-project.sh '\u003curlpath\u003e' '\u003ctitle\u003e'\n```\n\n- `\u003curlpath\u003e`: ahol elérhetővé tennéd a projektedet, pl.: `'schpincer'` beírásával `kir-dev.sch.bme.hu/projects/schpincer/` elérési útvonalat kapod. Használd csak a kisbetűs angol karaktereket, esetleg kötő- és underscore jeleket.\n- `\u003ctitle\u003e`: a projekted hivatalos neve, így fog a weboldalon megjelenni, itt már használhatsz szóközt és egyéb karaktereket is. (Később magában a markdown fájlban ezek változtathatóak.)\n\nSzerkesztéskor a projekt markdown fájljában:\n\n- A `github` fieldben megadhatod a projekt GitHub-os repóját a Kir-Dev organisation-ből.\n- A `status` fieldben megadhatod a projekt jelenlegi állását, illetve hogy milyen színű pötty jelenjen meg a felirat mellett a project previewban. Pl.: `status: { label: 'Aktív', color: 'green' }` esetén az Aktív felirat mellett zöld pötty fog megjelenni, mindig az utolsó szó adja meg a színt.\n  - Használhatóak ilyen feliratok, mint `{label: 'Tervezés alatt', color: 'green'}`, `{label: 'Fejlesztés alatt', color: 'green'}`, `{label: 'Üzemel', color: 'green'}`, `{label: 'Megszakadt', color: 'red'}`, `{label: 'Áll', color: 'orange'}` de lehetőleg maradjunk értelmes feliratoknál és színeknél a konzisztencia érdekében (aktív fázisokban inkább a zöld színt használjuk, a szöveg lehet akármi, inaktívaknál a vörös és narancssárga ajánlott).\n  - Extra: `Archivált` label megadása esetén hold ikon jelenik meg a státusz feliratban, `Kész` vagy `Üzemel` esetén egy pipa, `Áll` vagy `Megszakadt` esetén pedig egy felkiáltójeles kör alakú ikon.\n- A `techs` fieldben megadhatod vesszővel elválasztva egy tömbben a projekt főbb techjeit (lehetőleg maradj max 3-nál). Pl.: `techs: ['TypeScript', 'Node.js']`\n- A `website` field akár elhagyható, ha nincs tipikus kir-deves oldala a projektnek.\n- **FONTOS:** képeket projektleírásba a [warp drive](https://warp.sch.bme.hu/)-on keresztül tegyél be. Jelentkezz be, készíts egy albumot, tedd be a képeket, és jobb egér a képnézegetőben, majd Copy Image address.\n\n## Hozzáadnál új tagot a csapathoz?\n\nAz `src/content/members/active.yaml` fájlt kell kiegészíteni egy új tömbelemmel.\n\n**FONTOS:** A képet, amit magadhoz rendelnél, Warp-on a https://warp.sch.bme.hu/albums/12 albumba töltsd fel és onnan linkeld (a vicces mehet https://warp.sch.bme.hu/albums/13 albumba).\n\n## Tanfolyamok\n\nÉrdemes lehet átírni a már meglévő kurzus entitásokat a `content/courses` könyvtárban.\n\nSzerkeszteni tudod a hozzárendelt tulajdonságokat a létrejött markdown fájlban:\n\n- `title`: Cím\n- `lecturer`: Előadó neve\n- `sessions`: Egy tömb, amelyben objektumonként megadod az egyes alkalmak időpontját és helyét.\n  - Fun fact: TanulóSCH-n új feature a tanulószobától független események rendezése, így akár belinkelhetsz egy TanulóSCH eseményt is.\n- `active`: jelenleg aktív-e a tanfolyam, ha false, nem jelenik meg a tanfolyam oldalon sem\n- A leírást pedig írd meg a markdown fájl további részében.\n\n## License\n\n- Front page header background image by Chris Reid on Unsplash: https://unsplash.com/photos/LfG7RwMM6g8\n- Terminal component (with little customization) by [vercel/hyper-site](https://github.com/vercel/hyper-site) (MIT license)\n- Default post featured image by Clément Hélardot on Unsplash: https://unsplash.com/photos/95YRwf6CNw8\n- Background svgs clipped together from [undraw.co](https://undraw.co/) images by Katerina Limpitsouni\n\nThe following directories and their contents are Copyright Kir-Dev.\nYou may not reuse anything therein without Kir-Dev's permission:\n\n- posts/\n\nAll other directories and files are MIT Licensed.\n\n[1]: https://github.com/kir-dev/kir-dev.sch.bme.hu/pulls\n\n## Sponsors\n\n\u003ca href=\"https://vercel.com?utm_source=kir-dev\u0026utm_campaign=oss\"\u003e\u003cimg src=\"static/svg/powered-by-vercel.svg\" height=\"46\" /\u003e\u003c/a\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkir-dev%2Fblog-next","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkir-dev%2Fblog-next","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkir-dev%2Fblog-next/lists"}