Markdown으로 아름다운 pdf 문서 작성하기 - LaTeX, pandoc, nvim, zathura

sudo pacman -S pandoc

sudo pacman -S neovim

# zathura는 pdf 출력을 위한 의존 패키지인 zathura-pdf-mupdf도 함께 설치해야 한다.
sudo pacman -S zathura zathura-pdf-mupdf 

from: markdown
to: pdf
pdf-engine: xelatex # 보유한 한글 ttf폰트를 사용하기 위해 xelatex을 사용한다.

toc: false                 # 목차 비활성 (원하면 true)
toc-depth: 3               # 목차 표기 시 깊이 설정
number-sections: false     # 섹션 번호 매기기 비활성
standalone: true

# 문서 메타데이터(언어 등)
metadata:
  lang: en                 # 문서 언어(ko/en)

variables:
  documentclass: extarticle # article, book, extarticle 등 LaTeX의 doc class를 설정
  classoption: [a4paper]   # a4paper, b5paper 등 latex의 용지 옵션을 설정

  # article/report 표준: 10/11/12pt, ext~ 양식은 14/16pt 등 더 큰 글자 사용 가능.
  fontsize: 14pt

  # 줄간격
  linestretch: 1.4 

  # 용지 여백 설정
  geometry: top=30mm,bottom=30mm,left=25mm,right=25mm 

  # 하이퍼링크 색상 사용 여부
  colorlinks: true 

% kotex 패키지 사용
\usepackage[cjk]{kotex}
\usepackage{amsmath,amssymb}

% 들여쓰기 사용
\usepackage{indentfirst}
\setlength{\parindent}{1.5em}  % 원하는 들여쓰기 크기
\setlength{\parskip}{0pt}    % 문단 간 여백 제거

% english font 설정
\setmainfont{NanumMyeongjo}
\setsansfont{NanumGothic}
\setmonofont{D2Coding}

% hangul font 설정
\setmainhangulfont{NanumMyeongjo}
\setsanshangulfont{NanumGothic}
\setmonohangulfont{D2Coding}

% hyperlink의 색상 설정
\usepackage[svgnames]{xcolor} % DarkBlue, Crimson 등 확장 색 이름 사용
\makeatletter
\@ifpackageloaded{hyperref}{}{\usepackage{hyperref}}
\makeatother
\AtBeginDocument{
  \hypersetup{
    colorlinks=true,
    linkcolor=DarkBlue,   % 내부 링크(목차/섹션)
    urlcolor=Teal,     % URL 링크
    citecolor=DarkGreen,  % 인용(참고문헌)
    filecolor=Teal
  }%
}

-- custom/zk-preview라는 플러그인이 markdown 파일을 열때만 lazy load하도록 설정하는 파일
return {
  dir = vim.fn.stdpath 'config' .. '/lua/custom/zk-preview',
  ft = { 'markdown' }, -- Markdown 파일 열릴 때만 로드
}

-- === ZK Markdown → PDF (on save) ===
-- markdown을 pdf로 변환하는 함수를 정의하는 파일로, 다음의 형태로 동작한다.
-- 요구사항:
--  - pandoc, xelatex (TeX Live), zathura
--  - header.tex: \usepackage{kotex} 등 한글/수식 설정
--
-- 동작:
--  - *.md 저장 시 pandoc으로 /tmp/<파일이름>.pdf 빌드
--  - 성공하면 zathura가 그 PDF를 이미 열었는지 검사
--  - 안 열려 있으면 zathura를 (백그라운드로) 실행
--  - 열려 있으면 zathura의 자동 리로드를 활용 (새로 안 띄움)

local M = {}

-- 본인 환경에 맞게 'header.tex' 경로 지정
M.header_tex = vim.fn.expand '$HOME/.pandoc/defaults/header.tex'

-- 선택: 이미지 등 리소스가 저장될 경로, :를 통해 여러개를 작성 가능.
-- 현재는 '.'과 '100 Attachment'를 지정. 
-- 필요없으면 '.'만 남기면 됨.
M.resource_path = '.:100 Attachment'

-- pandoc 인자
M.pandoc_args_base = {
  '-f',
  'gfm+tex_math_dollars', -- $$ 수식을 인식을 위함.
  '--pdf-engine=xelatex', -- 폰트 사용을 위해 pdf 엔진으로 xelatex을 사용
  '--defaults=' .. vim.fn.expand '$HOME/.pandoc/defaults/pdf.yaml', -- pandoc의 옵션을 사전에 만든 파일로 전달
}

-- 저장 트리거 enable/disable 토글, default는 false
M.enabled = false

-- 수동 실행용 커맨드 (:ZkPreviewBuild)
vim.api.nvim_create_user_command('ZkPreviewBuild', function()
  local buf = vim.api.nvim_get_current_buf()
  M.build_pdf_for_buf(buf)
end, {})

-- 토글 커맨드 (:ZkPreviewToggle)
vim.api.nvim_create_user_command('ZkPreviewToggle', function()
  M.enabled = not M.enabled
  vim.notify('ZK Preview on save: ' .. (M.enabled and 'ENABLED' or 'DISABLED'))
end, {})

-- 내부: 현재 버퍼를 PDF로 빌드
function M.build_pdf_for_buf(buf)
  local src = vim.api.nvim_buf_get_name(buf)
  if src == '' or vim.fn.filereadable(src) == 0 then
    return
  end
  if vim.fn.fnamemodify(src, ':e') ~= 'md' then
    return
  end

  -- 현재는 /tmp에 pdf를 저장하고 있음. 필요시 다른 경로로 설정 가능.
  local out_pdf = '/tmp/' .. vim.fn.fnamemodify(src, ':t:r') .. '.pdf'

  -- pandoc 실행을 위한 명령어 구성
  local args = { 'pandoc', src, '-o', out_pdf }
  for _, a in ipairs(M.pandoc_args_base) do
    table.insert(args, a)
  end
  if M.header_tex and M.header_tex ~= '' then
    table.insert(args, '--include-in-header=' .. M.header_tex)
  end
  if M.resource_path and M.resource_path ~= '' then
    table.insert(args, '--resource-path=' .. M.resource_path)
  end

  -- pandoc으로 빌드 실행
  vim.fn.jobstart(args, {
    stdout_buffered = true,
    stderr_buffered = true,
    on_exit = function(_, code)
      if code == 0 then
        -- zathura가 이미 out_pdf를 열고 있는지 점검
        vim.fn.jobstart({ 'ps', '-C', 'zathura', '-o', 'args=' }, {
          stdout_buffered = true,
          on_stdout = function(_, data)
            local opened = false
            for _, line in ipairs(data or {}) do
              if line and line:match(vim.pesc(out_pdf)) then
                opened = true
                break
              end
            end
            if not opened then
              -- 열린 zathura 창이 없으면 새로 오픈 (백그라운드 포크)
              vim.fn.jobstart { 'zathura', '--fork', out_pdf }
            end
          end,
        })
        vim.schedule(function()
          vim.notify('PDF built: ' .. out_pdf, vim.log.levels.INFO)
        end)
      else
        vim.schedule(function()
          vim.notify('Pandoc build failed (exit ' .. tostring(code) .. ')', vim.log.levels.ERROR)
        end)
      end
    end,
  })
end

-- toggle enabled 상태에서 저장을 인지하면 자동으로 pdf 변환을 수행
vim.api.nvim_create_autocmd('BufWritePost', {
  pattern = '*.md',
  callback = function(args)
    if M.enabled then
      M.build_pdf_for_buf(args.buf)
    end
  end,
})

-- 주석 제거 전
...
  --  Uncomment the following line and add your plugins to `lua/custom/plugins/*.lua` to get going.
  -- { import = 'custom.plugins' },
...

-- 주석 제거 후
...
  --  Uncomment the following line and add your plugins to `lua/custom/plugins/*.lua` to get going.
  { import = 'custom.plugins' },
...

# Title: [[20240812111622 data manipulation-based distribution generalization]]

Data generalization 기법의 세 가지 분류 계통 중의 하나로, 데이터들을 가공하여 모델이 Out-of-distribution 문제에 대해 좀 더 일반화된 특성을 학습할 수 있도록 만드는 방식이다.
Data manipulation에 기반한 DG 기법이 OOD와 in-distribution 모두에서 유의미하게 예측할 수 있음을 실험을 통해 확인한 사례가 있다[^1].

data manipulation을 통한 DG의 목표를 수식으로 표현하면 다음과 같다.
이때 $\mathcal{M}(\cdot)$은 manipulation function이다.
$$
\min_h \mathbb{E}_{\mathbf{x},y} [\ell(h(\mathbf{x}), y)] + \mathbb{E}_{\mathbf{x}',y}[\ell(h(\mathbf{x}'), y)]
$$
$$
\mathbf{x}' = \mathcal{M}(\mathbf{x})
$$

[^1]: 참조문헌 2

***
Created : 2024-08-12 11:16:22

Tags : [[out-of-distribution]] - [[generalization]] - [[preprocessing]]

Related note : 

References :  

- J. Wang et al., “Generalizing to Unseen Domains: A Survey on Domain Generalization,” IEEE Trans. Knowl. Data Eng., pp. 1–1, 2022, doi: 10.1109/TKDE.2022.3178128.
- D. Adila and D. Kang, “Understanding Out-of-distribution: A Perspective of Data Dynamics,” Nov. 29, 2021, arXiv: arXiv:2111.14730. Accessed: Aug. 12, 2024. [Online]. Available: http://arxiv.org/abs/2111.14730

-- NOTE: markdown to pdf
vim.keymap.set('n', '<leader>mm', '<cmd>ZkPreviewToggle<CR>', { desc = 'Toggle ZK PDF preview (on save)' })