본문으로 건너뛰기

작동 방식

여러분의 입력이 들어가고, 배포된 웹사이트가 나오며, 모든 운영은 그 옆에 있습니다.

Foundation은 명확한 경계를 가진 한 방향의 흐름으로 이해하는 것이 가장 쉽습니다. 여러분이 소유한 것이 들어가고, 나오는 것은 직접 호스팅하는 정적 웹사이트이며, 비즈니스를 운영하는 시스템에 연결되어 있습니다.

  • 사이트 고유의 입력, Foundation의 기계, 배포된 여러분의 사이트
  • 외부 시스템은 Foundation 옆에 있고 안에 있지 않습니다
  • 아래의 모든 것은 저장소에서 검증할 수 있습니다

여러분이 소유한 입력

흐름의 왼쪽에 있는 것은 여러분의 것이고 그대로 남습니다. 플랫폼 코드는 없습니다.

  • 구성

    아이덴티티, 언어, 내비게이션, 기능 스위치, UI 결정 — 흩어진 상수가 아니라 검증된 설정입니다.

  • 콘텐츠

    페이지와 컬렉션은 저장소의 파일이며 각각 고유한 제목과 본문을 가집니다.

  • 번역

    언어별 UI 사전과 해당 언어의 콘텐츠 디렉터리입니다.

  • 브랜드와 자산

    로고, favicon, 소셜 미리보기, 선택적 시각 자료를 각각 이름이 붙은 역할로 다룹니다.

이 모든 것을 기반의 아키텍처를 건드리지 않고 바꿀 수 있습니다.

Foundation이 그것들로 하는 일

Foundation은 입력을 읽고 사이트를 만듭니다. 이것이 여러분이 만들 필요가 없는 부분이며, 빌드하고 배포할 때 실행되고 방문자를 기다리게 하지 않습니다.

  1. 1

    검증

    구성과 사전이 스키마에 대해 검사되므로 잘못된 설정은 방문자에게 도달하지 않고 빌드가 실패합니다.

  2. 2

    콘텐츠와 라우팅

    페이지가 콘텐츠 인터페이스로 로드되고 안정적인 주소를 받으며, 번역이 없으면 페이지 단위로 기본 언어로 돌아갑니다.

  3. 3

    표현

    콘텐츠와 아이덴티티가 공유 토큰 시스템으로 라이트 또는 다크에서 모든 화면 폭으로 구성됩니다.

  4. 4

    가시성과 메타데이터

    제목, 정규 주소, 언어 주석, 구조화 데이터, 사이트맵과 robots 출력이 여러분의 구성에서 생성됩니다.

  5. 5

    연동 지점

    기능을 활성화한 곳에서 Foundation이 연결을 그리고 방문자의 의도를 여러분의 제공자에게 넘깁니다.

  6. 6

    출력

    정적 웹사이트로 빌드되어 여러분의 계정과 도메인으로 배포됩니다.

여기에 빌려 쓰는 서비스는 없습니다. 같은 저장소를 실행할 수 있는 어디서든 빌드할 수 있습니다.

Foundation 옆에서 동작하는 것, 안이 아닌 것

Foundation은 의도 — 예약하기, 길 안내 받기, 메시지 보내기 — 를 표현하고, 그 뒤의 목적지는 여러분이 정합니다. Foundation 자체가 그 시스템이 되지는 않습니다.

  • 예약과 일정 조정
  • 문의와 메시지 수신
  • 지도와 길 안내
  • 분석
  • CRM과 고객 데이터
  • 결제와 회계
  • 고객 계정과 로그인
  • 이미 운영 중인 다른 시스템

외부 서비스는 연동 지점을 통해 연결됩니다. 서비스는 자신의 데이터, 규칙, 계정을 그대로 유지합니다.

Foundation 구하기부터 직접 유지하는 사이트까지

열 가지 실무 단계입니다. 세부는 저장소의 안내에 있고 이 페이지는 작업의 형태를 보여줍니다.

  1. 1

    구하기

    공개 저장소를 여러분의 계정으로 복제하거나 포크합니다.

  2. 2

    실행하기

    설치하고 실행해 무엇이든 바꾸기 전에 동작하는 사이트를 봅니다.

  3. 3

    구성하기

    아이덴티티, 언어, 내비게이션, 기능 스위치를 구성에서 정의합니다.

  4. 4

    브랜드 적용하기

    이름이 붙은 시각 역할을 자체 로고, favicon, 미리보기로 교체합니다.

  5. 5

    콘텐츠 작성하기

    페이지와 컬렉션을 저장소의 파일로 작성합니다.

  6. 6

    기능 선택하기

    필요한 것만 활성화합니다. 쓰지 않는 기능은 경로나 자리 표시자를 추가하지 않습니다.

  7. 7

    제공자 연결하기

    활성화한 각 연동 지점을 이미 쓰는 제공자로 향하게 합니다.

  8. 8

    검증하기

    품질 게이트와 브라우저 검증을 실행해 문제를 방문자보다 먼저 찾습니다.

  9. 9

    배포하기

    여러분의 계정과 도메인으로 빌드해 배포합니다.

  10. 10

    유지하기

    콘텐츠와 구성을 여러분의 것으로 유지하고 상위 개선은 선택한 시점에 받아들입니다.

안내서

이 사이트는 GitHub 안내의 두 번째 사본이 되지 않습니다.

누가 무엇을 소유하는가

Foundation은 빌려 쓰는 서비스가 아니라 여러분이 보유하는 인프라입니다. 분담은 의도적으로 단순합니다.

여러분이 소유하는 것

  • 구성, 아이덴티티, 내비게이션
  • 콘텐츠와 컬렉션
  • 언어 사전과 번역
  • 브랜드와 모든 시각 자료
  • 제공자 선택과 그 계정
  • 호스팅 계정, 도메인, 배포
  • 여러분이나 협력사가 이후에 추가하는 모든 것

Foundation이 소유하는 것

  • 재사용 가능한 아키텍처와 강제되는 경계
  • 표현 기계와 디자인 토큰
  • 라우팅과 콘텐츠 파이프라인
  • 구성 검증
  • 연동 지점
  • 검증 인프라

떠날 수도 있고, 여러분이 소유한 모든 것은 함께 갑니다. 저장소가 여러분의 출처입니다.

무언가를 바꾸면 어떻게 되는가

두 가지 의도적인 규칙이 이를 예측 가능하게 합니다. 존재를 정하는 것은 콘텐츠, 표현을 정하는 것은 구성이며, 어느 쪽도 다른 쪽을 조용히 만들어내지 않습니다.

  • 사이트 이름, 슬로건, 설명

    헤더, 푸터, 페이지 제목, 소셜 메타데이터, 구조화 데이터.

  • 페이지 자체의 파일

    그 페이지의 콘텐츠와 생성되는 사이트맵.

  • 사전 파일

    해당 언어의 UI 문자열.

  • 액센트 색상 토큰

    사이트 전반의 브랜드 요소와 강조 요소.

  • 로고, favicon, 미리보기 자산

    해당 시각 역할만.

  • 내비게이션 구성

    메뉴의 순서와 레이블. 페이지의 존재 여부는 바뀌지 않습니다.

  • 기능 스위치

    그 기능의 경로와 표면이 존재하는지 여부.

  • 영업 지역

    해당 지역의 영업 상태, 주소, 길 안내, 구조화 데이터.

선택적인 것이 없으면 아무것도 그리지 않습니다. 채우기 페이지도, 빌려온 시각 자료도, 빈 셸도 없습니다.

잘못된 변경이 일찍 실패하는 이유

구성은 방문자가 도착할 때가 아니라 사이트를 빌드할 때 검사되므로 오류가 즉시 드러납니다.

  • 알 수 없는 설정이나 잘못된 철자는 무시되지 않고 거부됩니다
  • 구조적으로 유효하지 않은 값은 해당 설정을 지목하며 빌드를 실패시킵니다
  • 구성되었지만 불완전한 기능은 조용히 아무것도 그리지 않고 실패합니다
  • 사전이 없는 언어는 조용히 다른 언어를 보여주지 않고 실패합니다

그래서 순환은 파일을 바꾸고, 빌드하고, 진실을 보는 것이며, 운영에서 발견하는 것이 아닙니다.

작업을 잃지 않고 개선 받아들이기

구성, 콘텐츠, 사전, 자산이 각자의 영역에 있고, 그것이 사이트를 다시 쓰지 않고 이후 개선을 받아들일 수 있게 합니다.

  • 업그레이드해도 사이트 고유 영역은 여러분의 것입니다
  • 개선을 받아들일 시점은 여러분이 정하며 강요되지 않습니다
  • 무엇이 왜 바뀌었는지 저장소가 기록하므로 결정에 근거가 있습니다

업그레이드 안내 읽기

이것은 문서화된 모델입니다. 자동 업데이트 서비스가 아니며 프로젝트는 그것을 주장하지 않습니다.

동작하는 기반에서 시작하세요

기능을 읽고, 이미 그 위에서 운영되는 두 비즈니스를 보고, 이미 동작하는 것에서 시작하세요.