Skip to content

Could you add some usage documentation for citation from citation? #409

@myme5261314

Description

@myme5261314

Bug Report

Disable all the other extensions except for LaTeX Workshop and LaTeX Utilities, and check that you still see this issue.

You still see this issue?: Yes

Describe the bug

A clear and concise description of what the bug is.

Apparently, the README and wiki content doesn't described the operation step to make the citation from zotero functionality works successfully.
I've spent one and a half day searching for guidance to use it, and finally make it work.
I'm not sure whether it's because my usage is wrong or the description in this section is too poor.

To Reproduce

Steps to reproduce the behaviour:

  1. Create a toy latex project with empty file test.bib and test.tex file with following content.
\documentclass[a4paper, 12pt, oneside]{book}
\usepackage[style = numeric-comp]{biblatex}
%\addbibresource[location=remote]{http://127.0.0.1:23119/better-bibtex/export/collection?/1/WNEMKQJ8.biblatex}
\addbibresource{test.bib}
\begin{document}
\autocite{prajwalLipSyncExpert2020}
\end{document}
  1. Save the file to trigger extension Latex Workshop to compile.
  2. You will get a citation undefined warning.
  3. Comment out the third line (the specific url is only for my zotero collection).
  4. Save the file to see the compiling product test.pdf, which is as expected.

Expected behaviour

A clear and concise description of what you expected to happen.

Anyone new to this extension should follow the instructions to use the cite from Zotero functionality.
Since there's no extra reminder has been stated, I feel really confused when I configured all the requirements but found the final step (latex compiling can't find the citation key) doesn't work.

What makes it so hard is concluded as follows:

  1. No direct link to the merged extension. https://github.com/bnavetta/vscode-zotero-latex You can see the sentence in the merged extension's README The functionality here has been merged into the [LaTeX Utilities](https://github.com/tecosaur/LaTeX-Utilities) extension.
  2. The README of vscode-zotero-latex described the mechanism in the sentence First of all, you'll need to export your library from Zotero to a BibLaTeX file. Better BibTex supports [several methods](https://retorque.re/zotero-better-bibtex/exporting/) such as automatic export to a .bib file and pulling from Zotero when compiling your LaTeX document. but give no showcase.

I will not explain all the detailed efforts to make the toy work such as Wireshark network traffic capturing or other diagnostic approaches and search engine workload and so on.

Logs

Please paste the whole log messages here, not parts of ones. It is very important to identify problems. If you think the logs are unrelated, please say so.

LaTeX Workshop Output
logs here
LaTeX Utilities Output
logs here
Developer Tools Console
logs here

Screenshots

If applicable, add screenshots to help explain your problem.

Desktop

  • OS: MacOS 13.7.5
  • VS Code version: 1.99.3
  • Extension version: 0.4.14

Additional context

Add any other context about the problem here.

Metadata

Metadata

Assignees

No one assigned

    Labels

    ℹ️ documentationImprovements or additions to documentation

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions