pingcap / website-docs

The next generation of PingCAP Docs. Powered by Gatsby ⚛️.
https://docs.pingcap.com/
MIT License
22 stars 33 forks source link

Truncated text in tidb-stable-zh-manual.pdf #186

Closed qiancai closed 7 months ago

qiancai commented 2 years ago

Describe the bug For all tables in https://download.pingcap.org/tidb-stable-zh-manual.pdf, the alignment is center and the columns are too narrow to show the full text. As a reader, I could not even see the full text to understand the document.

To Reproduce Steps to reproduce the behavior:

  1. Go to https://download.pingcap.org/tidb-stable-zh-manual.pdf.
  2. From the left TOC panel, click 部署标准集群 > 规划集群拓扑 > 混合部署拓扑.
  3. Check the table under 拓扑信息. image

Expected behavior

curiousRay commented 8 months ago

/assign

curiousRay commented 8 months ago

@qiancai Didn't get assigned immediately after I commented /assign

qiancai commented 8 months ago

@curiousRay Sorry for the late response. I've assigned this issue to you manually.

qiancai commented 8 months ago

Hi @curiousRay Thanks for taking this issue. 👍

Just would like to let you know that the source code of the doc PDF template is located in https://github.com/pingcap/docs-cn/blob/master/templates/template.tex. Hence, to update the source code, please create a pull request in pingcap/doc-cn.

qiancai commented 8 months ago

And if you need to test the PDF generation, please use the script at pingcap/docs-cn.

qiancai commented 7 months ago

Hi @curiousRay, we have provided a tutorial for self-service PDF generation. Please check 自助生成 TiDB 文档 PDF 教程 for more information.

curiousRay commented 7 months ago

@qiancai Get it!

dveeden commented 7 months ago

I think this might be the same issue: https://github.com/pingcap/docs/issues/15982

For other PDF related issues see https://github.com/pingcap/docs/issues?q=is%3Aopen+is%3Aissue+in%3Atitle+PDF

dveeden commented 7 months ago

Maybe switching to another image like https://hub.docker.com/r/pandoc/extra would be good.

rpaik commented 7 months ago

👋 @curiousRay, just a friendly reminder to submit your PR for TiDB Docs Dash by January 12 at 07:59 UTC. 🙏

Please reach out if you have any questions or need any help.

curiousRay commented 7 months ago

Raised a PR (https://github.com/pingcap/docs-cn/pull/16173) in the pingcap/docs-cn repo.

curiousRay commented 2 months ago

Maybe switching to another image like https://hub.docker.com/r/pandoc/extra would be good.

@dveeden Long time no see~ Just to tell you I've been working on a custom docker image using pandoc/extra. See https://hub.docker.com/r/nightkeeper/doc-build