CTAN Comprehensive TeX Archive Network

Directory macros/latex/contrib/babelbidi

README.md

Package: BabelBidi v1.2.0 (2026-11-17)

An extension to Babel’s bidirectional support.

Description

This package extends Babel's bidirectional support by correcting specific direction-sensitive behaviour and providing interfaces for text direction, layout, language selection, and font configuration, including glyph fallback with Lua.

It also provides directional boxes and direction-aware facilities for footnotes, lists, bibliographies, RTL cases, margin notes, and columns, together with configurable counter separators, Latin-language citations, and language selection for verbatim text. Targeted compatibility patches are supplied for commonly used packages.

It works with Babel under Lua (recommended), , and pdf, in documents with either an LTR or RTL main language.

Features

  • BabelBidi uses bidi's native interfaces on and provides the corresponding user-level interfaces through Babel on Lua and pdf.
  • Direction commands, environments, directional boxes, and overlapping text.
  • Directed footnotes and title notes, configurable footnote rules, and optional extra footnote layouts.
  • Direction controls for lists, bibliographies, cases, margin notes, and columns.
  • Font configuration, Lua glyph fallback, and layout patches for commonly used packages.
  • Engine logos that adapt to the surrounding language and text direction.

Installation

CTAN: tlmgr install babelbidi — Package page

GitHub: git clone https://github.com/gambi-shah/babelbidi.git

Usage

~latex documentclass{article} usepackage{babelbidi}

begin{document} Hey world! end{document} ~

Compile with Lua (recommended), , or pdf. Babel language options are supported.

Interfaces

BabelBidi provides the complete user-level interfaces of bidi and luabidi.

Some additional interfaces include:

  • \lr{...} and \rl{...} for language-aware text direction.
  • \Latincite for citations using the selected Latin language.
  • \latinverb and the latinverbatim environment for code and verbatim text.
  • \settextfont and \deflatinfont for font configuration with Unicode engines.
  • \fontfallback for glyph fallback with Lua.

Language Selection

Auxiliary Latin, LTR, RTL, and code languages are selected automatically and updated after each \babelprovide call. The latin, ltr, rtl, and code options override these choices. Declare languages before configuring fonts.

Documentation

See the main manual for configuration details and examples, including compatibility notes and engine-specific limitations.

The optional babelbidi.cwl provides studio completion for the package's commands and environments. Copy it to studio's user completion directory (~/.config/texstudio/completion/user/ on Linux).

The distribution also includes amikhteh-logo, a companion package used in the documentation. See its companion guide.

License and Maintainer

Download the contents of this package in one zip archive (404.1k).

BabelBidi – An extension to babel’s bidirectional support

This package extends Babel’s bidirectional support by correcting specific direction-sensitive behaviour and providing interfaces for text direction, layout, language selection, and font configuration, including glyph fallback with Lua.

It also provides directional boxes and direction-aware facilities for footnotes, lists, bibliographies, RTL cases, margin notes, and columns, together with configurable counter separators, Latin-language citations, and language selection for verbatim text. Targeted compatibility patches are supplied for commonly used packages.

It works with Babel under Lua (recommended), , and pdf, in documents with either an LTR or RTL main language.

PackageBabelBidi
Bug tracker
Repository
Version1.2.0 2026-11-17
LicensesThe Project Public License 1.3c
Copyright2026 Amer Amikhteh
MaintainerAmer Amikhteh
Contained inTeX Live as babelbidi
MiKTeX as babelbidi
TopicsMulti-lingual
Bidirectional
...
Guest Book Sitemap Contact Contact Author