Bibliography.jl
Bibliography.jl is a Julia package for handling both import/export from various bibliographic formats.
Organization
This package comes as a set of 3 packages to convert bibliographies. This tool was split into three for the sake of the precompilation times.
- Bibliography.jl: The interface to import/export bibliographic items.
- BibInternal.jl: A julian internal format to translate from and into.
- BibParser.jl: A container for different bibliographic format parsers (such as BibTeX).
Packages using Bibliographies
- StaticWebPages.jl: a black-box generator for static websites oriented towards personal and/or academic pages. No knowledge of Julia nor any other programming language is required.
Contributions are welcome
- Write new or integrate existing parsers to BibParser.jl (currently only a light BibTeX parser is available).
- Add import/export from existing bibliographic formats to Bibliography.jl.
- Add export for non-bibliographic formats (such as in StaticWebPages.jl).
Short documentation
# Import a BibTeX file to the internal bib structure
imported_bib = import_bibtex(source_path::AbstractString)
# Select a part of a bibliography
selection = ["key1", "key2"]
selected_bib = select(imported_bib, selection) # select the intersection between the bibliography and `selection`
diff_bib = select(imported_bib, selection; complementary = true) # select the difference between the bibliography and `selection`
# Export from internal to BibTeX format
export_bibtex(target_path::AbstractString, bibliography)
# Check BibTeX rules, entry validity, clean and sort a bibtex file
export_bibtex(target_path::AbstractString, import_bibtex(path_to_file::AbstractString))
# Export from internal to the Web Format of StaticWebPages.jl
export_web(bibliography)
# Export from BibTeX to the Web Format of StaticWebPages.jl
bibtex_to_web(source_path::AbstractString)