Back to blog
2025년 2월 23일 오전 05:02
3 min read

astro + astro-sphere 설치하기

astro-sphere 를 다운로드, astro 를 업그레이드, obsidian 설정, 로컬에서 실행하기

1. astro-sphere 다운로드, package 설치, astro update

# node 20 사용
$ nvm use v20 

$ git clone https://github.com/markhorn-dev/astro-sphere.git astro-blog

$ cd astro-blog

$ pnpm i

$ pnpm update astro==5.3.0

$ pnpm run dev 

# http://localhost:4321 
  • 공식 사이트에서 안정적인 node version 확인
  • 다운로드 받은 astro-sphere 엔 astro 4.5.5 설치됨
  • 공식 사이트의 astro 버전이 많이 올라갔길래, astro update 진행.
  • 로컬 실행이 잘 되어 이렇게 사용할 예정

2. work, projects 메뉴 숨김, 제목 수정, SNS 정보수정

src/const.ts 내에서 주석처리

// Global

export const SITE: Site = {
	TITLE: "Beta10's Blog",
	DESCRIPTION: "beta10의 블로그 입니다.",
	AUTHOR: "Beta10",
}

...


// Links
export const LINKS: Links = [
	{
		TEXT: "Home",
		HREF: "/",
	},
	// {
	// TEXT: "Work",
	// HREF: "/work",
	// },
	{
		TEXT: "Blog",
		HREF: "/blog",
	},
	// {
	// TEXT: "Projects",
	// HREF: "/projects",
	// },
]

...

// Socials

export const SOCIALS: Socials = [
{
	NAME: "Email",
	ICON: "email",
	TEXT: "[email protected]",
	HREF: "mailto:[email protected]",
},
// {
// 	NAME: "Github",
//	ICON: "github",
//	TEXT: "markhorn-dev",
//	HREF: "https://github.com/markhorn-dev/astro-sphere"
// },
// {
//	NAME: "LinkedIn",
//	ICON: "linkedin",
//	TEXT: "markhorn-dev",
//	HREF: "https://www.linkedin.com/in/markhorn-dev/",
// },
// {
// 	NAME: "Twitter",
//	ICON: "twitter-x",
//	TEXT: "markhorn_dev",
//	HREF: "https://twitter.com/markhorn_dev",
//},
]

brand.svg 검색 후, 주석처리

  • src/components/Footer.astro
  • src/components/Header.astro
<!-- svg class="size-6 fill-current">
	<use href="/brand.svg#brand"></use>
</svg -->

3. Obsidian 설정 & 기존 글 옮기기

  • Obsidion에서 ‘보관함 관리하기’ > ‘보관함 폴더 열기’ > src/content 폴더를 선택
  • 기존 글이 몇개 없어서 손으로 이전
  • 원래 소스에 포함된 글을 삭제하거나, Draft: true 로 변경하기
  • 로컬 브라우저에서 내용 확인

4. Github Repo 추가 & push

$ git remote rm origin

$ git remote add origin [email protected]:beta10/blog.git

$ git add .

$ git commit -m "first commit"

$ git push -u origin main 

5. Cloudflare page 에 Github Repo 연결

  • cloudflare page 회원가입 후
  • 컴퓨팅 > pages 에서 github 와 연동설정
  • 위에서 projects 를 숨김처리해서, src/content/projects 폴더가 남아있으니 빌드시 오류 발생
  • projects 폴더 삭제후 git push 하면 자동으로 build 후 배포 성공
  • 도메인 등록 후, 도메인 연결(https://beta10.net/, https://www.beta10.net)
  • Obsidian 에서 글 수정 후, git push 하면 30초 정도 후 빌드 & 배포

6. SNS 정보 숨기기