부트스트랩 5 레이아웃 가져오기
부트스트랩 5 템플릿을 bx_Import에서 헤더, 푸터, 유연한 섹션 템플릿 및 LayoutHTML로 분해하고, 이후 bluetronix 편집기에서 다시 조합하는 방법을 배웁니다.
튜토리얼 목표
이 튜토리얼에서는 기존의 부트스트랩 5 레이아트를 bluetronix CMS로 가져옵니다. 이 과정에서 원래 HTML 페이지를 헤더, 푸터, 개별 섹션 템플릿 및 실제 레이아웃 틀로 나누게 됩니다. 이후에는 편집기에서 각 페이지 섹션을 자유롭게 삽입하고, 이동하며, 여러 번 사용할 수 있습니다.
참고: 이 튜토리얼은 기본 레이아웃 가져오기 방법을 다룹니다. 이미지의 추가 편집 또는 교체에 대한 내용은 다음 튜토리얼에서 다룰 예정입니다.
1. bx_Import에서 원본 템플릿 열기
파일 관리자에서 bx_Import 폴더를 열어보세요. 이곳에서 가져온 레이아트는 원본 상태로 존재합니다 - 예를 들어, 원래의 이미지 폴더와 HTML 파일이 포함되어 있습니다. 이 영역에서는 기존의 원본 파일만 사용하며, 변경 내용은 원본 템플릿에 저장되지 않습니다.
이 예제를 위해 index.html 파일을 열고 편집으로 전환합니다. 이 파일은 이제 CMS 레이아웃의 개별 구성 요소로 분해됩니다.
스크린샷 자리: 열려 있는 bx_Import 폴더, 이미지 폴더 및 원본 HTML 파일이 포함된 파일 관리자 - dev_bootstrap_import_bx_import_originaldateien.jpeg. 이미지 촬영 후 이 자리에 삽입하세요.
스크린샷 자리: HTML 편집기에서 bx_Import의 index.html - dev_bootstrap_import_index_html_bearbeiten.jpeg. 이미지 촬영 후 이 자리에 삽입하세요.
2. index.html에서 헤더 분리하기
HTML 코드에서 Ctrl + F로 header를 검색합니다. 많은 Bootstrap 템플릿에서 헤더는 해당 HTML 요소로 표시되어 빠르게 찾을 수 있습니다. 일부 템플릿에서는 헤더가 단순히 div 영역으로 구성되어 있으므로, 이 경우 구조를 더 자세히 확인해야 합니다.
전체 헤더 영역을 선택하고 복사합니다. 원본 템플릿과 CMS 프로젝트 간에 전환할 수 있도록 두 개의 창을 열고 작업하는 것이 좋습니다.
스크린샷 자리: 검색을 통해 index.html의 헤더 영역 찾기 및 복사하기 위해 선택됨 - dev_bootstrap_import_header_markieren.jpeg. 이미지 촬영 후 이 자리에 삽입하세요.
3. 헤더를 CMS에 삽입하기
프로젝트로 돌아가서 루트 디렉터리를 열고, 헤더 → HTML 코드로 이동합니다. 이전에 복사한 헤더 코드를 그곳에 붙여넣습니다.
그 후 로컬 경로를 확인하세요. 많은 레이아웃에서 상대 참조와 이미지 경로는 접두사 슬래시가 있어야 CMS 구조 내에서 올바르게 작동합니다.
href="css/style.css" → href="/css/style.css"
src="images/logo.jpg" → src="/images/logo.jpg"
중요: 검색 및 바꾸기를 위해 Ctrl + H를 사용하되, 경로를 맹목적으로 바꾸지 마세요. 특히 외부 URL, 앵커, mailto:-링크 및 이미 절대 경로를 확인하세요.
스크린샷 자리: 주요 디렉토리 → 헤더 → 삽입된 헤더가 있는 HTML 코드 – dev_bootstrap_import_header_html_einfuegen.jpeg. 이미지를 추가하고 이후 이 위치에 연결하세요.
4. 푸터 분리 및 삽입하기
그 다음 원본 index.html에서 푸터를 찾으세요. 전체 푸터 영역을 잘라내거나 복사하여 프로젝트의 주요 디렉토리에 있는 푸터 파일에 붙여넣으세요. 거기에서도 모든 로컬 href 및 src 경로를 확인하세요.
스크린샷 자리: 삽입된 푸터 코드가 있는 주요 디렉토리의 푸터 파일 – dev_bootstrap_import_footer_html_einfuegen.jpeg. 이미지를 추가하고 이후 이 위치에 연결하세요.
5. 메인 영역을 개별 섹션 템플릿으로 나누기
헤더와 푸터를 제외한 페이지 내용은 당신의 프로젝트 index.html에 직접 복사되지 않습니다. 대신 bx_Layout → SectionTemplate.txt → HTML 코드를 여세요.
원본 템플릿의 남은 메인 영역을 이 파일의 끝에 붙여넣으세요. 그런 다음 이를 나중에 편집기에서 별도로 제공될 개별 영역으로 나누세요.
두 개의 섹션 템플릿 사이에 정확히 다음 구분자를 넣으세요:
<!--__SP_SectionTemplate__-->
따로 구분된 각 섹션은 나중에 편집기에서 자신의 템플릿으로 삽입될 수 있습니다. 이를 통해 섹션을 자유롭게 배치하고 반복적으로 사용하거나 한 페이지에서 생략할 수 있습니다.
스크린샷 자리: 여러 섹션 및 구분자 <!--__SP_SectionTemplate__-->가 있는 bx_Layout → SectionTemplate.txt – dev_bootstrap_import_sectiontemplate_trenner.jpeg. 이미지를 추가하고 이후 이 위치에 연결하세요.
6. Layout 틀을 00_layout에 삽입하기
헤더, 푸터 및 메인 섹션을 잘라낸 후 실제 HTML 프레임이 남습니다. 예를 들어 DOCTYPE, head 영역 및 기타 상위 레이아웃 요소가 포함됩니다. 이 남은 코드를 복사하세요.
그 후 데이터베이스 관리자를 열고 데이터베이스 00_layout를 편집하세요. 그곳에는 이미 레이아웃 템플릿이 제공됩니다. 기존 템플릿을 편집하거나 새 레이아웃을 만들 수 있습니다.
복사한 프레임을 LayoutHTML 아래에 붙여넣으세요. 헤더, 주요 내용 및 푸터의 원래 위치에는 CMS 마크업을 사용하세요:
__DB_Layout_Header__
__DB_Layout_Main__
__DB_Layout_Footer__
페이지가 렌더링될 때 이러한 마크는 각각의 헤더, 현재 메인 페이지 및 푸터로 대체됩니다. 관련 PHP 코드는 레이아웃 로딩 시 자동으로 실행됩니다.
스크린샷 자리: LayoutHTML 및 헤더, 메인 및 푸터에 대한 마크가 있는 데이터베이스 00_layout – dev_bootstrap_import_00_layout_layouthtml.jpeg. 이미지를 추가하고 이후 이 위치에 연결하세요.
7. CSS, JavaScript 및 파비콘 경로 점검하기
레이아웃 코드 내에서 CSS, JavaScript 및 파비콘 파일에 대한 모든 참조를 확인하세요. 로컬 경로에 필요한 접두사 슬래시를 추가하세요. CSS 및 JavaScript 파일의 경우 CMS의 파일 버전 표기를 추가로 사용하세요.
JavaScript 호출은 다음과 같이 보일 수 있습니다:
<script src="__FV_/bx_script/core.min.js__"></script>
태그 __FV_...__는 시스템이 파일 버전 또는 수정 날짜를 렌더링할 때 고려하도록 합니다. 이를 통해 브라우저는 변경 후에 수동으로 캐시를 업데이트하지 않고도 최신 CSS 또는 JavaScript 파일을 로드할 수 있습니다.
8. Head 내용을 정리하고 헤더 HTML 사용하기
적용된 head 영역을 검토하고 CMS에 의해 이미 설정되었거나 다른 곳에서 로드되는 내용을 제거하세요. 시스템이 자동으로 생성하는 페이지 제목도 제거할 수 있습니다.
편집기에서 필요하지만 LayoutHTML의 직접적인 일부로 만들고 싶지 않은 헤더 코드는 기타 → 헤더-HTML에 저장하세요. 이를 통해 편집기는 페이지 편집 시 거기에 저장된 내용을 고려할 수 있습니다.
스크린샷 자리: 기타 → 헤더-HTML에 이동된 헤더 코드를 포함하는 – dev_bootstrap_import_extras_header_html.jpeg. 이미지를 추가하고 이후 이 위치에 연결하세요.
9. 페이지를 위한 가져온 레이아웃 선택하기
00_layout에서 새 레이아웃을 만들었다면 편집기에서 페이지 설정을 열고 가져온 레이아웃을 선택하세요. 그래야 관련 페이지가 해당 레이아웃 프레임으로 표시됩니다.
스크린샷 자리: 새로 가져온 레이아웃 선택 시 페이지 설정 – dev_bootstrap_import_seiteneinstellungen_layout.jpeg. 이미지를 추가하고 이후 이 위치에 연결하세요.
10. 가져온 섹션으로 시작 페이지 조합하기
페이지에서 편집을 클릭하세요. 시작 페이지가 처음에는 비어 있을 수 있습니다. 이는 새로운 페이지 섹션이 실제 페이지에 아직 삽입되지 않았기 때문에 정상입니다.
삽입 → 페이지 섹션을 선택하세요. 거기에는 이전에 SectionTemplate.txt에서 섹션 구분 기호를 사용하여 분리한 영역이 표시되어야 합니다.
필요한 섹션을 차례로 추가하여 원본 페이지를 재구성하세요. 이후 섹션을 자유롭게 이동하거나 삭제하거나 여러 번 추가할 수 있습니다.
스크린샷 자리: 편집기 → 삽입 → 가져온 섹션 템플릿을 포함한 페이지 섹션 – dev_bootstrap_import_sections_einfuegen.jpeg. 이미지를 촬영하고 이후 이 자리에서 삽입하세요.
11. 원본 페이지를 참조로 사용하기
파일 → bx_Import에서 원본 index.html을 미리 볼 수 있습니다. 이를 참조하여 새로운 CMS 페이지를 개별 섹션으로 구성하세요.
개별 템플릿에서 이미지가 처음에 누락된 경우, 그 올바른 통합은 이후의 튜토리얼에서 다룰 것입니다.
12. 모든 섹션의 경로 및 편집 가능성 점검하기
마지막으로 Sections → Section Template를 다시 한 번 확인하고 모든 로컬 경로를 점검하세요. 유사한 경로가 많을 경우, 텍스트 편집기에서 Ctrl + H를 사용하여 효율적으로 변경할 수 있습니다.
편집기에서 가져온 각 섹션을 테스트하세요. 모든 내용이 올바르게 표시되고, 예정된 텍스트와 요소를 편집할 수 있는지 확인하세요.
예를 들어, 텍스트를 편집할 수 없는 경우, 그 HTML 구조를 확인하세요. 일반 텍스트가 직접 div 컨테이너에 있을 경우, 구조에 따라 해당 텍스트를 적절한 p 요소로 이동시키는 것이 유용할 수 있습니다.
스크린샷 자리: 섹션을 삽입하고 배열한 후 완전히 구성된 시작 페이지 – dev_bootstrap_import_fertige_startseite.jpeg. 이미지를 촬영하고 이후 이 자리에서 삽입하세요.
13. 왜 레이아트를 분리하는가
헤더, 푸터, 레이아웃 프레임 및 개별 섹션의 분리를 통해 새로운 페이지를 만들 때마다 원본 부트스트랩 파일에서 이 구성 요소를 복사하지 않아도 됩니다.
중앙 헤더와 푸터는 재사용할 수 있으며, 개별 페이지 섹션은 편집기에서 유연한 템플릿으로 제공됩니다. 이렇게 하면 부트스트랩 템플릿에서 다양한 페이지를 구성하고 콘텐츠 순서를 언제든지 변경할 수 있습니다.
요약
부트스트랩 5 가져오기를 위해 bx_Import에서 원본 파일을 템플릿으로 사용하세요. 헤더와 푸터는 지정된 CMS 영역에 별도로 통합되고, 메인 영역은 SectionTemplate.txt를 통해 개별 템플릿으로 분리되며, 남은 HTML 프레임은 00_layout → LayoutHTML 아래에 저장됩니다.
이후 페이지 설정에서 레이아웃을 선택하고 삽입 → 페이지 섹션을 통해 가져온 섹션으로 페이지를 구성하세요. 마지막으로 모든 경로, CSS 및 자바스크립트 참조 및 개별 섹션의 편집 가능성을 점검하세요.
FAQ
고객들이 자주 묻는 질문
원본 부트스트랩 템플릿이 bx_Import에 남아 있는 이유는 무엇인가요?
폴더 bx_Import는 가져온 원본 템플릿의 출발점 및 참조로 사용됩니다. 필요한 구성 요소는 해당 CMS 영역으로 통합됩니다.
첫 번째 가져오기에 어떤 파일을 사용하나요?
이 튜토리얼에서는 index.html을 출발점으로 사용합니다. 이 파일에서 헤더, 푸터, 메인 섹션 및 남은 레이아웃 프레임을 분리합니다.
HTML 코드에서 헤더와 푸터를 빠르게 찾으려면 어떻게 하나요?
Ctrl + F를 사용하여 헤더나 푸터를 검색하세요. 해당 HTML 태그가 없는 템플릿의 경우, 둘러싸고 있는 div 구조를 더 자세히 확인해야 합니다.
각 개별 페이지 섹션은 어디에 저장되나요?
템플릿은 bx_Layout에서 SectionTemplate.txt에 저장되며, 구분자는 <!--__SP_SectionTemplate__-->입니다.
LayoutHTML에 어떤 마크가 필요합니까?
분리된 영역의 위치에는 __DB_Layout_Header__, __DB_Layout_Main__ 및 __DB_Layout_Footer__를 사용합니다.
왜 CSS 및 JavaScript 파일에 __FV_ 태그가 붙어 있나요?
이를 통해 CMS가 렌더링 시 파일 버전 혹은 수정 날짜를 고려할 수 있습니다. 수정 후 브라우저는 최신 파일을 로드하고, 구식 캐시 버전을 사용하지 않게 됩니다.
왜 레이아웃 가져오기 후 시작 페이지가 처음에 비어있나요?
레이아웃은 우선 프레임만 제공합니다. 실제 페이지 섹션은 삽입 → 페이지 섹션을 통해 페이지에 추가해야 합니다.
수입된 페이지 섹션을 여러 번 사용할 수 있나요?
네. 개별 섹션 템플릿은 필요에 따라 에디터에서 삽입, 이동 및 여러 번 사용할 수 있습니다.
상대적인 이미지 또는 링크 경로가 작동하지 않을 경우 어떻게 하나요?
로컬 href 및 src 경로를 확인하고 필요 시 앞에 슬래시를 추가하세요. Ctrl + H를 사용하여 반복되는 경로를 대체할 수 있지만 외부 URL, 앵커 및 다른 특수 경로는 귀찮게 수정하지 마세요.
에디터에서 텍스트를 수정할 수 없을 때는 어떻게 하나요?
해당 섹션의 HTML 구조를 확인하세요. 일반 텍스트가 div 컨테이너 안에 직접 있는 경우 적절한 p 요소가 필요할 수 있습니다.
원본 페이지를 재구성할 때 어떻게 비교하나요?
파일 → bx_Import 아래의 원래 index.html 파일을 열고 미리보기에서 섹션의 순서와 구조를 참조로 사용하세요.