{"id":26273022,"url":"https://github.com/jdy8739/simple-ssg","last_synced_at":"2025-07-20T14:04:16.070Z","repository":{"id":276631223,"uuid":"929802223","full_name":"jdy8739/simple-ssg","owner":"jdy8739","description":"간단한 ssg(static site generator) 시스템 구현 프로젝트","archived":false,"fork":false,"pushed_at":"2025-03-07T15:10:40.000Z","size":23,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-07T16:24:29.319Z","etag":null,"topics":["filereader","javascript","mustache-templates","static-site-generator"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jdy8739.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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":"2025-02-09T12:48:00.000Z","updated_at":"2025-03-07T15:10:44.000Z","dependencies_parsed_at":null,"dependency_job_id":"efc76391-899c-4281-8f60-6af55b97ed36","html_url":"https://github.com/jdy8739/simple-ssg","commit_stats":null,"previous_names":["jdy8739/simple-ssg"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/jdy8739/simple-ssg","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jdy8739%2Fsimple-ssg","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jdy8739%2Fsimple-ssg/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jdy8739%2Fsimple-ssg/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jdy8739%2Fsimple-ssg/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jdy8739","download_url":"https://codeload.github.com/jdy8739/simple-ssg/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jdy8739%2Fsimple-ssg/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266135685,"owners_count":23881803,"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":["filereader","javascript","mustache-templates","static-site-generator"],"created_at":"2025-03-14T08:14:39.414Z","updated_at":"2025-07-20T14:04:16.045Z","avatar_url":"https://github.com/jdy8739.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# SIMPLE SSG 🚀⚡\n### 미완성 html, 마크다운을 완성된 html 문서로 빌드하는 간단한 SSG 시스템\n\n이 프로젝트는 **프레임워크에서 제공하는 정적 빌드의 원리를 이해하고**,  \n작은 규모로 직접 적용해 본 실험적인 프로젝트입니다.  \n프레임워크 없이 직접 구현해 보며 빌드 프로세스를 경험하는 것이 목적입니다.  \n\n이 링크를 새 탭에서 열려면 우클릭 후 \"새 탭에서 열기\"를 선택하세요.\n\u003ca href=\"https://simple-ssg.vercel.app\" target=\"_blank\"\u003e배포 링크\u003c/a\u003e\n\n---\n\n## 🎯 **프로젝트 목표 (Goals)**  \n\n✅ **HTML 문서의 빈 공간을 필요한 데이터로 채워 정적 빌드 수행**  \n✅ **마크다운(.md) 파일을 HTML로 변환하는 정적 변환 시스템 구현**  \n✅ **정적 사이트 생성(SSG)의 기초 원리 학습 및 적용**  \n\n---\n\n## 🏗 **주요 기능 (Features)**  \n\n- **정적 HTML 빌드** 🏗  \n  - 데이터 소스를 기반으로 HTML 파일을 완성하여 빌드  \n\n- **마크다운 변환 시스템** ✍  \n  - `.md` 파일을 HTML로 변환하여 정적인 페이지 생성  \n\n---\n\n## 🛠 **기술 스택 (Tech Stack)**  \n\n- **[front-matter](https://hexo.io/docs/front-matter)** - 마크다운 파일의 **메타데이터(YAML Front Matter)**를 파싱하는 라이브러리  \n- **[mustache](https://mustache.github.io/)** - HTML 템플릿 엔진으로, 변수 치환 및 템플릿 렌더링 기능 제공, 정적 HTML을 동적으로 생성  \n- **[showdown](https://showdownjs.com/)** - Markdown → HTML 변환기  \n- **[static-server](https://www.npmjs.com/package/static-server)** - 간단한 정적 파일 서버 제공  \n\n---\n\n## 🚀 **설치 및 실행 방법 (Installation \u0026 Setup)**  \n\n이 프로젝트를 실행하려면 **Node.js 20 이상**이 필요합니다.  \n아래 명령어를 실행하여 프로젝트를 로컬에서 실행할 수 있습니다.  \n\n```sh\n# 의존성 설치\nyarn\n\n# 프로젝트 빌드\nyarn build\n\n# 정적파일 서버 구동\nyarn serve\n```\n\n---\n\n## 💡 배운 점 \u0026 기술적 인사이트 (Learnings \u0026 Insights)\n\n🔹 마크다운을 HTML로 변환하고 정적 페이지를 생성하는 과정 이해  \n🔹 Front Matter를 활용한 메타데이터 관리 및 템플릿 엔진(mustache) 적용 경험  \n🔹 정적 빌드 원리를 직접 구현하며 프레임워크의 SSG 방식에 대한 개념 확립   ","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjdy8739%2Fsimple-ssg","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjdy8739%2Fsimple-ssg","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjdy8739%2Fsimple-ssg/lists"}