Skip to content

Conversation

@fakela
Copy link
Contributor

@fakela fakela commented Oct 20, 2025

Converted the TBL whitepaper from the original LaTeX source (https://github.com/ton-blockchain/ton/blob/master/doc/tblkch.tex) to Markdown.
This version replaces the earlier PDF-based conversion.

Closes the following:

#114
#547

Known differences (to be fixed in future releases):


@fakela fakela changed the title Convert tblkch latex to whitepaper Convert tblkch latex to web whitepaper v2 Oct 20, 2025
@fakela fakela marked this pull request as draft October 20, 2025 10:00
@fakela
Copy link
Contributor Author

fakela commented Oct 21, 2025

@reveloper I have crossed check this by first converting the latex to pdf using this tool: https://cloudconvert.com/tex-to-pdf and reviewing them side by side

@reveloper
Copy link
Collaborator

@fakela Could you highlight the diffrences(between webpage render and TeX render) you still notice between these documents but can't be arragned with mintify? It's maybe helpful for further review and improvements.

@fakela
Copy link
Contributor Author

fakela commented Oct 21, 2025

@fakela Could you highlight the diffrences(between webpage render and TeX render) you still notice between these documents but can't be arragned with mintify? It's maybe helpful for further review and improvements.

Thanks! From my side, the TeX and webpage renders match on code, text, highlighted math expression, and general formatting. I think this is a direct match now.

The one issue I have is with HASH. In the Tex PDF, it renders as: H (regular capital) + ASH (small caps), creating a subtle size distinction. However, in Mintlify/web, I had to use$\text{HASH}$ with all regular capitals because true small caps aren't supported. However when I did conversion from latex to markdown with a claude it kept it as Hash.

(Please let me know what style to use)

This is one of those differences between TeX and web rendering that can't be perfectly replicated
Screenshot 2025-10-22 at 01 12 10

@reveloper
Copy link
Collaborator

reveloper commented Oct 24, 2025

Let me share extra for possible fixes.

I ignore all link formatting and link addressing during this review, since we should resolve this in a separate update.

@novusnota, @verytactical
I listed the differences with the "need fix" and "ok" checkboxes.
Please help us define what we should or should not fix: mark each as an issue to fix with "need fix" or ignore with "ok".

PS: I marked obvious issues as Need fix by default.

  1. The quotes style is different
Screenshot 0007-10-24 at 13 37 01
  • Need fix
  • Ok

  1. Different paragraph alining
Screenshot 0007-10-24 at 13 39 40
  • Need fix
  • Ok

  1. Spacing before brackets. Seems similar, but PDF version doesn't include space.
Screenshot 0007-10-24 at 13 44 25
  • Need fix
  • Ok

  1. Contents page excluded from web version
Screenshot 0007-10-24 at 13 50 26
  • Need fix
  • Ok

  1. Number formatted with comma
Screenshot 0007-10-24 at 13 55 00
  • Need fix
  • Ok

  1. PDF has a specific styling for variable like CellRepr and SHA.
Screenshot 0007-10-24 at 14 00 07 Screenshot 0007-10-24 at 14 10 02
  • Need fix
  • Ok

  1. The visual difference between the italic and the default font in the web page is tiny (example completion tag), so this highlighting is almost unseen.
Screenshot 0007-10-24 at 14 02 34
  • Need fix
  • Ok

  1. Minor differences in header formatting: first header sentence changed to ### Header without a dot.
Screenshot 0007-10-24 at 14 16 22
  • Need fix
  • Ok

  1. Lost underscore in account_id
Screenshot 0007-10-24 at 14 23 33
  • Need fix

  1. Didn't render to wide dash (within all file)
Screenshot 0007-10-24 at 14 25 48
  • Need fix

  1. Code formatting minor diffrences
Screenshot 0007-10-24 at 15 01 44
  • Need fix
  • Ok

  1. Lost ; in the web version
Screenshot 0007-10-24 at 15 07 04
  • Need fix

  1. Dash list changed to a bullet point list
Screenshot 0007-10-24 at 15 15 40
  • Need fix
  • Ok

  1. Lost italic formatting for witness
Screenshot 0007-10-24 at 15 20 26
  • Need fix

  1. Lost paragraph spacing
Screenshot 0007-10-24 at 15 23 00
  • Need fix

  1. Lost comma in the 1.3.9
Screenshot 0007-10-24 at 15 25 14
  • Need fix

  1. In the formula ... seems a bit different
Screenshot 0007-10-24 at 15 29 48
  • Need fix
  • Ok

  1. In the formula ^-like and V letter seems different
Screenshot 0007-10-24 at 15 31 50 Screenshot 0007-10-24 at 15 34 08
  • Need fix
  • Ok

  1. Lost italic formatting in ch 1.3.12
Screenshot 0007-10-24 at 15 36 05
  • Need fix

  1. Lost italic formatting in ch 1.3.16
Screenshot 0007-10-24 at 15 42 29
  • Need fix

  1. LT different formatting within entire document
Screenshot 0007-10-24 at 15 59 27
  • Need fix
  • Ok

  1. Formula render doesn't fit in the page in ch. 1.4.2
Screenshot 0007-10-24 at 16 01 49
  • Need fix

  1. Lost . in header name
Screenshot 0007-10-24 at 16 03 50
  • Need fix

  1. Lost italic format for begins and ends
Screenshot 0007-10-24 at 16 05 47
  • Need fix

  1. Lost italic format for final
Screenshot 0007-10-24 at 16 16 30
  • Need fix

  1. Lost italic format for sentence
Screenshot 0007-10-24 at 16 19 59
  • Need fix

  1. Lost italic format
Screenshot 0007-10-24 at 16 23 10
  • Need fix

  1. Lost italic format
Screenshot 0007-10-24 at 16 24 55
  • Need fix

  1. Excluded dots in headers
Screenshot 0007-10-24 at 16 26 36 Screenshot 0007-10-24 at 16 26 47
  • Need fix
  • Ok

  1. Lost italic format
Screenshot 0007-10-24 at 16 50 18
  • Need fix

  1. Lost italic format
Screenshot 0007-10-24 at 16 53 51
  • Need fix

  1. Sum symbol format a bit different
Screenshot 0007-10-24 at 17 17 33
  • Need fix
  • Ok

  1. List style different: bullet points vs dashes.
Screenshot 0007-10-24 at 17 32 12
  • Need fix
  • Ok

  1. Difference in TL-B.
Screenshot 0007-10-24 at 17 35 31
  • Need fix

  1. Number formatted with comma
Screenshot 0007-10-24 at 20 07 57
  • Need fix
  • Ok

@fakela
Copy link
Contributor Author

fakela commented Oct 24, 2025

@reveloper, I wanted to point out something for issue 22 and (potentially other related ones), the formula render does fit the page (it shows full on my monitor screen). I'll say the formulas are probably not responsive for smaller screens. This might be something we can bring up with the mintlify team
Screenshot 2025-10-24 at 09 35 51

@fakela
Copy link
Contributor Author

fakela commented Oct 27, 2025

  1. Difference in "Nexthop"
Screenshot 2025-10-27 at 02 05 25
  • Need fix
  • Ok
  1. Difference in "LT" format
Screenshot 2025-10-27 at 01 44 53
  • Need fix
  • Ok
  1. Difference in the "F" format. This "F" format appears in multiple places
Screenshot 2025-10-27 at 01 17 05
  • Need fix
  • Ok
  1. Difference in the "z" format
Screenshot 2025-10-27 at 01 40 07
  • Need fix
  • Ok
  1. Overflow of code due to non-responsiveness in smaller screens
Screenshot 2025-10-27 at 01 44 53
  • Need fix
  • Ok
  1. Overflow of code due to non-responsiveness in smaller screens
Screenshot 2025-10-27 at 01 50 20
  • Need fix
  • Ok
  1. Overflow of code due to non-responsiveness in smaller screens
Screenshot 2025-10-27 at 01 51 33
  • Need fix
  • Ok

@reveloper
Copy link
Collaborator

reveloper commented Oct 28, 2025

@fakela
Previously, point 5, uploaded image - wrong.
Numbers formatted with a comma, but should be the same.

Screenshot 0007-10-28 at 14 14 43

@reveloper
Copy link
Collaborator

reveloper commented Oct 28, 2025

Extra for review

  1. ~ seems different
Screenshot 0007-10-28 at 15 50 07
  • Need fix
  • Ok

@fakela
Copy link
Contributor Author

fakela commented Oct 28, 2025

Extra for review

  1. ~ seems different
Screenshot 0007-10-28 at 15 50 07
  • Need fix
  • Ok

WIP

@reveloper this is what it looks like on the tex file. I think the curl ~ placement is okay

\begin{verbatim}
ahm_edge#_ {n:#} {X:Type} {Y:Type} {l:#} {m:#} 
  label:(HmLabel ~l n) {n = (~m) + l} 
....

@fakela fakela marked this pull request as ready for review November 3, 2025 01:31
@verytactical verytactical requested review from reveloper and removed request for verytactical November 4, 2025 14:36
@reveloper
Copy link
Collaborator

LGTM, the only issue I faced related to SHA/Sha/sha formating, I prefer to fix it later with minor updates. Let's merge this.
@verytactical

@reveloper reveloper merged commit 1770b6b into ton-org:main Nov 5, 2025
2 checks passed
laviniat1996 pushed a commit that referenced this pull request Nov 5, 2025
Complete transfer from LaTeX to webview of the TON Blockchain whitepaper.
aigerimu pushed a commit that referenced this pull request Nov 6, 2025
Complete transfer from LaTeX to webview of the TON Blockchain whitepaper.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants