파이썬 책은 어떻게 코드문서 출판이 하나로 가능했는가

파이썬 책은 어떻게 코드 문서 출판이 하나로 가능했는가? :

패키지: 우분투: 리눅스:::quarto : 쿠알토 Write Books

(웨스 맥키니 2023) 이 책 웹 페이지를 보면 이거 어떻게 가능했던 것인가?! 이 것이 어떻게 가능했는가 보려면? Quarto - quarto.org 를 알아야 한다. 이 녀석으로 출간 했다고 한다. 이맥스에도 패키지가 있다. 리눅스 패키지도 있다. 무엇이길래 뭐가 좋길래 어떻게 하는 것인가?

문제는 이 책의 코드만 공개되어 있다. 문서가 없다.

단계적으로 접근하자. 일단 책을 완성하는 연습이라면

[2024-06-03 Mon 17:32] 조직모드로 통합해야 한다. 그래야 열린다. 지식과 코드가 합쳐 질 수 있다.

quarto

Quarto is an open-source scientific and technical publishing system built on Pandoc. Quarto documents are authored using markdown, an easy to write plain text format.

ox-quarto : emacs packages

jrgant/ox-quarto - github.com

qmd 로 내보내기. 즉. 이맥스로 끄적이고 내보내기. 근데 이게 필요가 있나? 잠시만. 실제 내용을 다루어 본다면?

git@github.com:junghan0611/ox-quarto.git

DONE quarto-cli build on ubuntu

출판하려면 엄청난 툴을 다운 받아야 한다. 아무렴 빌드하니까 오래걸린다. 굳이 이렇게 할 필요가 있나 싶긴 하다만.

quarto-dev/quarto-cli - github.com

The ./configure.sh script should add a symlink to quarto to your path. You can also run quarto by running package/dist/bin/quarto.

git clone https://github.com/quarto-dev/quarto-cli
cd quarto-cli
./configure.sh

결과

> Didn't create symlink at /usr/local/bin/quarto
> Trying ~/.local/bin/quarto
> Symlink created at /home/junghan/.local/bin/quarto
> Success
++ type -p quarto
+ quarto_loc=/home/junghan/.local/bin/quarto
+ [[ -z /home/junghan/.local/bin/quarto ]]
+ export QUARTO_DENO_EXTRA_OPTIONS=--reload
+ QUARTO_DENO_EXTRA_OPTIONS=--reload
+ quarto --version
99.9.9

pandoc 버전 사용을 보자. 패키지로 다운 받아 사용한 버전과

➜ quarto pandoc –version pandoc 3.1.11

여기서 방금 빌드한 개발 버전이다.

➜ ~/.local/bin/quarto pandoc –version

Check </home/junghan/nosync/apps/quarto-cli/src/quarto.ts> pandoc 3.2

DONE quarto org mode format support

별 도움 안될 것 같다.

Quarto – Emacs Org-Mode Options - quarto.org

DONE (Hadley Wickham [2015] 2024) “hadley/r4ds : R for data science: a book using Quarto” 완벽한 예제

여기에 가면 전체 책 문서와 코드가 있다.

The “Communicate” part remains, but has been thoroughly updated to feature Quarto instead of R Markdown. This edition of the book has been written in Quarto, and it’s clearly the tool of the future.

‘의사소통’ 부분은 그대로 유지하되, R 마크다운 대신 쿼토를 사용하도록 완전히 업데이트했습니다. 이 책은 Quarto로 작성되었으며, 미래의 도구가 될 것이 분명합니다

Related-Notes

References