{"id":17321931,"url":"https://github.com/petercorke/tkbibtex","last_synced_at":"2025-03-27T03:21:17.065Z","repository":{"id":93428643,"uuid":"250911236","full_name":"petercorke/tkbibtex","owner":"petercorke","description":"Simple python/tk graphical browser/editor for BibTeX files","archived":false,"fork":false,"pushed_at":"2020-03-28T23:15:52.000Z","size":121,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-02-01T08:45:42.328Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/petercorke.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-03-28T23:03:53.000Z","updated_at":"2023-09-04T16:09:13.000Z","dependencies_parsed_at":null,"dependency_job_id":"731a7003-d8b9-4579-bcd4-e83f8489c557","html_url":"https://github.com/petercorke/tkbibtex","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/petercorke%2Ftkbibtex","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/petercorke%2Ftkbibtex/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/petercorke%2Ftkbibtex/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/petercorke%2Ftkbibtex/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/petercorke","download_url":"https://codeload.github.com/petercorke/tkbibtex/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245773377,"owners_count":20669765,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-10-15T13:40:21.505Z","updated_at":"2025-03-27T03:21:17.046Z","avatar_url":"https://github.com/petercorke.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# TKBIBTEX - portable BibTeX editor and browser\n\n## SYNOPSIS\n\n```\ntkbibtex [bibfile]\n```\n\n## DESCRIPTION\n\n`tkbibtex`\nis a portable editor and browser for BibTeX format file.  It is written in\nTcl/Tk and runs under Unix or Windows based wish interpreters.\nIt is inspired by, or modeled on, an ancient OpenWindows application called `bibcard`.\nIt also has a non-GUI command line mode which is useful for generating\npublication lists.\n\n`tkbibtex` supports 3 different windows:\n\n1. A scrolling list of cite keys\nwhich has a toolbar with File, Edit and Help menus.\nThe bibtex file can be given on the command line (it will be searched for along\nthe path given by the BIBPATH envariable), or opened via the File/Open\ncommand.\nThe current bib file name is shown in the title bar, as well as the modification\nstatus.\nDouble clicking on an entry brings up the selected citation in the\nbrowser window.  The up and down arrow keys can also be used to move up and down the citation list.\n\n2. The browser window shows all the fields associated with the selected entry\nand its title bar shows the citation key.\nThe fields shown depend on the citation type which can be changed by the \nreference type menu button.\nRequired fields have a bold label while optional fields have an italic label.\nString values are preceeded by a hash.\n\n3. The search window provides a wide variety of searching modes.  The search\ncan cover all fields or be limited to a specific field.\nThe search can be further\nconstrained by reference type and year range by specifying either or both\na starting and ending (inclusive) year.\nA list of matching cite keys is listed in this window, and once again\ndouble clicking or up/down arrow keys can be used to browse this list using\nthe browser window.\n\n## Features\nThe following are features I think are particularly cute.\n\n* In the browser window you can right-click in a field and it will bring up\na menu of string constants.  I normally define strings for journal names.\nThe name of the bibtex string file that is used to build the menu can\nbe set in the `.tkbibtexrc`\nfile (eg. set strfile strings.bib).  It is searched for along the `BIBPATH`.\n\n* The browser window has an `Annote' button which expands the annotation\nwindow.  This scrolling text entry box allows for an arbitrary amount of \nfreeform text to be stored\nin the bibtex file in the `ANNOTE` field.  This is useful for storing commentary\nor reviews of papers read.  This material does not appear in the bibliography\nwith any of the normal reference styles.\n\n* Multiple selection is enabled in the main and search window citation lists.\n\n* Edit/Copy copies the actual\nbibtex source of selected citations to the clipboard.\n\n* Edit/Paste pastes\nbibtex source into the bibliography.\n\n* Single-key shortcuts exist for most menu functions, see Help for details.\n\n* Every time tkbibtex writes an output file it copies the existing bib file to\na unique name.  These build up over time and should be periodically culled.\n\n# NON-GUI MODE\n`tkbibtex`\nalso has a command line mode\n\n`tkbibtex [switches] [bibfile]`\n\nwhich can be used to select entries from the \n`bibfile ` according to various filtering options.\n\n* `-type string`\napply search only to refernces of the specified type, ie. `article`\nor `inproceedings`. This can also be a regexp, eg. `article!inproceedings`\n\n* `-field string` apply search only to the specified field.\n\n* `-search string` filter out all citations that match this string\n\n* `-ys year` filter out articles with year greater than or equal to that specified (default 0)\n\n* `-ye year` filter out articles with year less than or equal to that specified (default 9999)\n\n* `-last nyears` filter out articles whose year falls within the last `nyears`\n\n* `-exact` make all searches case sensitive\n\n* `-count`\ninstead of outputting BibTeX entries to stdout, just count the matching\nreferences.\n\n* `-list`\ninstead of outputting BibTeX entries to stdout, provide a one\nline summary of the form \"key (type): title\".\n\nFor example, to count the number of journal papers jointly authored \nwith Foo before 1997, we could use the command line\n```\n% tkbibtex -count -ye 1997 -field author -search Foo   publist.bib\n```\n\n##FILES\nAt startup a file called `.tkbibtexrc`\nin the user's home directory is sourced if it exists.\n\n## ENVIRONMENT\n`BIBPATH`\nis a colon separated list of directories which will be searched for named\nbib files.\n\n## SEE ALSO\n`bibtex`, `latex`, `tcl`, `tk`\n\n## BUGS\nThe parser for the bibtex file format is simple minded and expects each\nrecord to occupy a single line, ending with a `}` or `},`.  The last line\nof each group must be a close brace on a line by itself.\nThis means that old, existing, bib files may need some manual editing \nbefore they will work with tkbibtex.\n\n# AUTHOR\nP.I. Corke (peter.i.corke@gmail.com) (17 March 2000)\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpetercorke%2Ftkbibtex","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpetercorke%2Ftkbibtex","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpetercorke%2Ftkbibtex/lists"}