#정적사이트생성기

2024-06-16 MetaWord meta ssg

Static Site Generator

(“Static Site Generator” 2024)

Static site generators (SSGs) are software engines that use text input files (such as Markdown, reStructuredText, AsciiDoc and JSON) to generate static web pages. Static sites generated by static site generators do not require a backend after site generation, making them first-class citizens on content delivery networks (CDNs). Some of the most popular static site generators are Jekyll, Hugo, Next.js (JavaScript). SSGs are typically for rarely-changing, informative content, such as product pages, news articles, software documentation, and blogs.

#휴고

#쿼츠

(Zhao [2021] 2024)

“jackyzha0/quartz” Zhao, Jacky 2024
- 🌱 a fast, batteries-included static-site generator that transforms Markdown content into fully functional websites

#댓글

#디스쿠스

이게 범용으로 쓰기 좋지

CANCELLED lume with Deno

[2023-07-25 Tue 12:11] 내가 사용할 예정이다. 모든 개발 환경을 하나로 통합하려는 노력

Docusaurus

[2023-07-25 Tue 12:12] 문서 버전 관리 기능이 좋은데 이 기능을 다른 서비스에서도 가능한가?

Material for MkDocs : Python

[2023-07-17 Mon 06:16] https://squidfunk.github.io/mkdocs-material/alternatives/

뭐가 특별한가? 파이썬으로 작성 되어 있음. 이게 한계 인듯. 나에게는 리엑트 베이스로 넘어갈 필요가 있다.

:스페이스맥스 :프렉티컬리

Spacemacs layers and emacs pkgs that I am using

문서의 목표는 분야, 카테고리, 섹션 뭐가 되었든 분류를 하는 것이다. 유구한 역사의 이맥스는 같은 주제로 다양한 패키지가 있다. 스페이스맥스는 이것들을 나름대로 분류하여 레이어라는 이름을 붙였다. 레이어에는 다양한 패키지가 있다. 패키지는 하나 그 이상의 역할을 하기도 하므로 여러 레이어에 걸쳐서 일종의 의존관계를 형성할 수 있다. 그렇기에 스페이스맥스를 사용하는 것은 모종의 선택을 한 것이다.

이는 어느 역할을 하는 패키지를 무작정 인터넷에서 좋다고 가져올 것이 아니라, 스페이스맥스에서 사용하는 패키지를 우선적으로 검토하고 의존 관계를 제거하는게 좋다는 말이다. 하나의 레이어는 여러 패키지를 설치하게 되고 모르는 사이에 활성화 되어 이맥스를 거듭 무겁게하기 때문이다. 그래서 둠으로 가고 바닐라고 가게 되지 않겠는가? 뭐든 좋다. 나는 스페이스맥스를 사용하는 목표와 이유가 있다.

설정은 간단하게. 입문자를 위한. 키바인딩 일관성 등을 고려 한다.

뻔한 레이어 패키지는 말고 딱 눈에 들어온 패키지에 대해서 생각하고 기록을 하자.

link-hint, `ace-link`, embark

link-hint 리포를 보다가 적었다. pentadactyl style 이라고 하는데 선택 가능한 텍스트에 임의의 알파벳을 붙여서 선택하게 돕는 툴이다. 마우스 이동/클릭 없이 키보드로 브라우징 하거나 텍스트 에디팅에 많이 사용 된다. ace-link 가 최선은 아닐수도 있으나 스페이스맥스 에 기본으로 들어있다. 어딘가 레이어에 있을 것이다. 편집 쪽에. 비슷한 역할이니 기본을 이용한다.

Practically Spacemacs Manual

mkdocs-material install with pipenv

[2024-01-23 Tue 17:18]

virtualenv 를 만들고 여기에 pyright 을 설치하고 Emacs 를 실행하는 방법. sandboxing 이 갈끔하겠지. 이래 하면 Emacs 설정 다 동작하나?!


pipenv 는 최신이다

$ pipenv shell

# (practical-spacemacs-doc) junghan-laptop :: ~/git/practical-spacemacs-doc ‹main*› » mkdo


$ pip3 install mkdocs-material mkdocs-callouts mkdocs-glightbox mkdocs-git-revision-date-localized-plugin mkdocs-redirects pillow cairosvg

$ make docs

잘된다. pipenv 가상 환경에서 설치 사이즈는 다음과 같다.

(practical-spacemacs-doc) junghan-laptop :: ~/git/practical-spacemacs-doc ‹main*› » du -sh
106M	.

TODO `[0/3]` Translation Status

deepl 이 해주면 된다. 넷플릭스로 호스팅 하면 된다.

Evil Basics
Magit
…

GITHUB REPO

[2023-09-09 Sat 16:42]

내가 작업 중인 리포 https://github.com/junghan0611/practical-spacemacs-doc

git@github.com:junghan0611/practical-spacemacs-doc.git ko 브레인치이다. 나는 이걸로 작업 을 할 것이다. 여기 이미지는 아래 그래픽 디자인에 연결 된다.

https://github.com/practicalli/spacemacs/

Graphic-Design

[2023-09-09 Sat 16:40]

포크해서 사용한다.

원래 리포는 다음과 같다. https://github.com/practicalli/graphic-design

Docusaurus / Gatsby / Vuepress : JS

[2023-07-17 Mon 06:21]

프레임워크. Gatsby 도 여기에 해당 한다.

Docusaurus by Facebook is a very popular documentation generator and a good choice if you or your company are already using React to build your site. It will generate a single page application which is fundamentally different from the site Material for MkDocs generates for you.

Docz, Gatsby, Vuepress and Docsify that approach this problem similarly.

CANCELLED Jekyll : Ruby

[2023-07-17 Mon 06:22]

CANCELLED 조직모드: 제킬 예제

[2023-08-10 Thu 10:20]

구성 어떻게 내 보낼 수 있는가

pandoc - gfm
ox-zenn gfm 변형임. 이미지를 내보내는 것이 문제네

요구사항

[2023-08-10 Thu 10:47] 내가 사용하는 필수 기능을 정리한다. 이미지는 내보내기 할 때 복사?! 수동도 괜찮다. 아무렴 어떤가. 이미지만 되면 된다.

ox-zenn 관련

[2023-08-10 Thu 11:11]

gfm 으로 내보내기가 이것만 먹힌다. 이걸로 해결해야 한다.

Examples

Heading

[2023-06-19 Mon 17:51] h2 은 레드 계열 heading 은 숫자보다는 정통 별표로 가는게 예쁘다.

Heading 2

헤딩 h3 yello 계열

Heading 3
h4 blue [2023-06-19 Mon 17:51]

Image

테스트. 이미지 위치를 어떻게 바꿀수 있을까? 내보내기가 되어야 한다.

지킬(Jekyll) 포스팅에 이미지 첨부하는 방법 총체적 정리 | 재윤 블로그 여기에 나와있는대로 정리하자.

And of course, images look great:

<img src="/assets/image.jpg"/>

assets/images/ 여기로 바뀌어야 한다. 아니라면 그냥 이미지는 외부 서비스로 박아 놓는 것도 좋겠다.

Image Test 1

Table

[2023-07-13 Thu 11:35]

Head	Head	Head
—-	—-	———
Text	Text	Teeeeeext
Text	Text	Text
Text	Text	Text
Text	Text	Text

Footnote 각주 관리

각주는 이렇게 들어갑니다. ¹

Markup

결과를 비교하면 org-code 와 verbatim 이 다르다. 맞춰줘야 한다. verbatim 은 맞추기가 까다롭다. kbd 을 많이 사용하라!

헤딩에는 _ 만 사용하라!
본문에는 ~, = 깔끔하다.
*, / 은 편하게 사용하되 헤딩에만 피해라!

org-bold : *
org-code : ~ (org-hugo-use-code-for-kbd t)
org-italic : /
~~org-strike~~ : +
org-underline : _
org-verbatim : =

Sphinx