RABBIT(1)

🐰 RABBIT(1) β€” the manual, but make it cute ✨

okay so bestie, you opened the manual for rabbit, and I'm gonna walk you through every single flag like we're texting in the group chat. no cap, nothing gets skipped. πŸ’…

πŸ“› NAME

rabbit β€” presentation tool using RD, simple text format.

πŸš€ SYNOPSIS

rabbit [options] [SOURCE_INFOS]

🌈 DESCRIPTION

okay so this is where the options live. buckle up, because there are a lot of them, and they're all lowkey iconic. πŸŽ€

🎨 Theme

  • -I, --include=PATH β€” Add [PATH] to load path.
  • -t, --theme=THEME β€” Use [THEME] as theme. Default: (default).
  • --comment-theme=THEME β€” Use [THEME] for comment. Default: ().
  • --allotted-time=TIME β€” Use [TIME] as allotted time. Default: ().

πŸ“š Source

  • -T, --type=TYPE β€” Specify source type as [TYPE]. Select from [auto, memory, uri, file, argf]. Note: case insensitive. Default: (auto).
  • When select Memory β€” specify [FILENAME_OR_NOT] as [SOURCE_INFOS].
  • When select URI β€” specify URI as [SOURCE_INFOS].
  • When select File β€” specify [FILENAME] as [SOURCE_INFOS].
  • When select ARGF β€” specify none (get from STDIN) or [FILE_NAMES] as [SOURCE_INFOS].
  • -e, --encoding=ENCODING β€” Specify source encoding as [ENCODING]. Default: (auto).
  • -B, --base=BASE β€” Specify base URI or path of source as [BASE]. Default: (auto).

πŸͺŸ Initial state

  • -f, --[no-]full-screen β€” Toggle full screen mode. Default: (off).
  • --[no-]index-mode β€” Toggle index mode. Default: (off).
  • --initial-slide=N β€” Show the Nth slide. (zero-based) Default: (0).

πŸ“ Size

  • -g, --geometry=GEOMETRY β€” Set window geometry [GEOMETRY]. Format: WIDTHxHEIGHT+X+Y. Default: (nil).
  • -w, --width=WIDTH β€” Set window width to [WIDTH]. Default: (800).
  • -h, --height=HEIGHT β€” Set window height to [HEIGHT]. Default: (600).
  • -S, --size=WIDTH,HEIGHT β€” Set window width and height to [WIDTH] and [HEIGHT]. Default: (800,600).

πŸ’Ύ Save

  • -s, --save-as-image β€” Save as image and exit.
  • -i, --saved-image-type=TYPE β€” Specify saved image type as [TYPE]. Default: (png).
  • -bBASE_NAME, β€” Specify saved image base name as [BASE_NAME].
  • --saved-image-base-name β€” (Title of slide)
  • --saved-image-basename
  • --[no-]output-html β€” Output HTML for viewing saved images. Default: (false).
  • --[no-]output-index-html β€” Output index HTML for navigating slides. Default: (false).
  • --rss-base-uri=URI β€” Specify base URI of RSS as [URI]. RSS is generated only when HTML is output. Default: ().
  • --source-filename=FILENAME β€” Specify source filenam as [FILENAME]. Default: ().

πŸ–¨οΈ Print

  • -p, --print β€” Print and exit.
  • -o, --output-filename=FILENAME β€” Specify printed out filename as [FILENAME]. Default: (#{Title of slide}.pdf).
  • --slides-per-page=SLIDES β€” Set slides per page. Default: (1).
  • --[no-]draw-scaled-image β€” Draw scaled image. Better look for displaying but lesser look for printing. Default: (auto).

πŸ“„ Paper

  • --paper-width=WIDTH β€” Set paper width to [WIDTH] Pt. Default: (landscape A4 width).
  • --paper-height=HEIGHT β€” Set paper height to [HEIGHT] Pt. Default: (landscape A4 height).
  • --paper-size=WIDTH,HEIGHT β€” Set paper width and height to [WIDTH] Pt and [HEIGHT] Pt. Default: (landscape A4 size).

πŸ“ Margin

  • --margin-left=MARGIN β€” Set left margin for slides per page mode print. Default: (auto).
  • --margin-right=MARGIN β€” Set right margin for slides per page mode print. Default: (auto).
  • --margin-top=MARGIN β€” Set top margin for slides per page mode print. Default: (auto).
  • --margin-bottom=MARGIN β€” Set bottom margin for slides per page mode print. Default: (auto).
  • --margin=[ALL] β€” Set margin for slides per page mode print.
  • --margin=[TOP_BOTTOM],[LEFT_RIGHT] β€” Set margin for slides per page mode print.
  • --margin=[TOP],[LEFT_RIGHT],[BOTTOM] β€” Set margin for slides per page mode print.
  • --margin=[TOP],[RIGHT],[BOTTOM],[LEFT] β€” Set margin for slides per page mode print.
  • --page-margin-left=MARGIN β€” Set left page margin. Default: (auto).
  • --page-margin-right=MARGIN β€” Set right page margin. Default: (auto).
  • --page-margin-top=MARGIN β€” Set top page margin. Default: (auto).
  • --page-margin-bottom=MARGIN β€” Set bottom page margin. Default: (auto).
  • --page-margin=[ALL] β€” Set page margin.
  • --page-margin=[TOP_BOTTOM],[LEFT_RIGHT] β€” Set page margin.
  • --page-margin=[TOP],[LEFT_RIGHT],[BOTTOM] β€” Set page margin.
  • --page-margin=[TOP],[RIGHT],[BOTTOM],[LEFT] β€” Set page margin.

πŸ’Ž dRuby

  • --[no-]use-druby β€” Specify whether to use dRuby. Default: (true).
  • --druby-uri=URI β€” Specify dRuby URI. Default: (druby://127.0.0.1:10101).
  • --[no-]output-druby-uri β€” Specify whether to output dRuby URI. Default: (false).

🧼 SOAP

  • --[no-]use-soap β€” Specify whether to use SOAP. Default: (false).
  • --soap-host=HOST β€” Specify SOAP host as [HOST]. Default: (0.0.0.0).
  • --soap-port=PORT β€” Specify SOAP port as [PORT]. Default: (10103).

πŸ“‘ XML-RPC

  • --[no-]use-xmlrpc β€” Specify whether to use XML-RPC. Default: (false).
  • --xmlrpc-host=HOST β€” Specify XML-RPC host as [HOST]. Default: (0.0.0.0).
  • --xmlrpc-port=PORT β€” Specify XML-RPC port as [PORT]. Default: (10104).

πŸ”“ Public level

  • --public-level=LEVEL β€” Specify public level. Select from the following: [ strict, move, read-size, change-size, size, read-source, change-source, source, control, all ]. Default: (all).

πŸ’¬ Comment

  • --comment-source=FILE β€” Deprecated. Just ignored. Specify initial comment source. Default: (default source).
  • --comment-encoding=ENCODING β€” Deprecated. Just ignored. Specify comment source encoding. Default: (auto).

πŸ”Ž Migemo

  • --migemo-dictionary-search-path=PATH1,PATH2,... β€” Specify search paths for Migemo static dictionary. Default: (/usr/share, /usr/local/share).
  • --migemo-dictionary-name=NAME β€” Specify static dictionary name for Migemo. Default: (migemo-dict).

🧊 3D

  • --[no-]use-gl β€” Specify whether to use OpenGL if available. Default: (false).

🫢 Others

  • --check-syntax β€” Check slide source syntax and exit.
  • --[no-]show-native-window-id β€” Show a native window ID of the Rabbit window if available. e.g. The ID is the ID of X resource on X window system. Default: (false).

🧰 Common options

  • --options-file=FILE β€” Load options from FILE. Default: (none).
  • --locale-dir=DIR β€” Specify locale dir as [DIR]. Default: (auto).
  • --logger-type=TYPE β€” Specify logger type as [TYPE]. Select from [stderr, gui]. Default: (STDERR).
  • --log-level=LEVEL β€” Specify log level as [LEVEL]. Select from [debug, info, warning, error, fatal, unknown]. Default: (info).
  • --help β€” Show this message.
  • --version β€” Show version.

This page is from rabbit 3.0.0, dated August 2020. mwah πŸ’‹βœ¨