Esoteric Software

[Harald]

Great to hear, thanks very much in advance!

[wiige]

the update of API Reference for runtime 4.1 here:

[updated]zh_API_ref.zip

BTW, the link

<a href='http://esotericsoftware.com/spine-skeleton-manipulation#Generic-rendering'>Generic rendering</a>

in API Reference is invalid now , I reckon it need to be modified:

1658256652572.png

[Harald]

Thanks so much for your all your great efforts! We have updated the translated documentation page with your latest version:
API 参考文档 - Spine Runtimes Guide

The new Generic Rendering link now points here:
Runtime Skeletons - Spine Runtimes Guide: Generic rendering
I have updated both your Chinese translation page and the English pages (with and without -beta suffix) with the new link.

spine-api-reference-zh.zip

---

FYI: Two short lines have been added as hints in the Shaders section of the spine-unity documentation, regarding shadow-receiving:
https://diffy.org/diff/719f261817f03
These are very minimal changes, so it would make perfect sense to wait until the next update so that the overhead is not dominating the actual work.

---

FYI: new larger sections have been added to the spine-unity docs page, regarding SkeletonRenderTexture and SkeletonRenderTextureFadeout example components, also mentioned in the FAQ section.
The diff of these changes can be found here:
https://diffy.org/diff/17cda3a95659d

I have created a new unified diff of the last two diffs (the one above and this one) here:
https://diffy.org/diff/228d05f50809f

[wiige]

Thanks so much for your all your great efforts! We have updated the translated documentation page with your latest version:
API 参考文档 - Spine Runtimes Guide

The new Generic Rendering link now points here:
Runtime Skeletons - Spine Runtimes Guide: Generic rendering
I have updated both your Chinese translation page and the English pages (with and without -beta suffix) with the new link.

spine-api-reference-zh.zip

---

FYI: Two short lines have been added as hints in the Shaders section of the spine-unity documentation, regarding shadow-receiving:
https://diffy.org/diff/719f261817f03
These are very minimal changes, so it would make perfect sense to wait until the next update so that the overhead is not dominating the actual work.

---

FYI: new larger sections have been added to the spine-unity docs page, regarding SkeletonRenderTexture and SkeletonRenderTextureFadeout example components, also mentioned in the FAQ section.
The diff of these changes can be found here:
https://diffy.org/diff/17cda3a95659d

I have created a new unified diff of the last two diffs (the one above and this one) here:
https://diffy.org/diff/228d05f50809f

DONE!~
unified diff of the last two diffs do great help, thanks！

spine-unity-zh_CN-SkeletonRenderTexture.zip

[Harald]

Thanks very much for your super quick translation work once again!
I've updated the page with your content accordingly:
spine-unity 运行时文档

unified diff of the last two diffs do great help, thanks！

Strangely I don't see the translation part of the first commit (which was included in the unified diff), did you perhaps send us the wrong file?
https://diffy.org/diff/719f261817f03
Anyway, it's just a minor addition that is not so important.

I also noticed that for some reason the cross-section links like e.g.

[link text](从Spine导出文件到Unity)

as I've added for testing are behaving strangely on this single page: they don't scroll to the selected heading as they should, but when opening the link in a new tab it works as intended. I will see what we can do about it.
---
Do you also see the same behaviour with the first link in this section here reading 从Spine导出文件到Unity.:
spine-unity 运行时文档: 导入问题
Or is it working in your browser, scrolling to the right section? At least for us using Firefox or Chrome it does not scroll unfortunately.

[wiige]

appreciate for your chariness! I compared the present translation for Spine/Sprite/Pixel Lit and Universal Render Pipeline/Spine/Sprite with diffs, the excrescent sentences The only shader that receives per-pixel realtime shadows. and Receives per-pixel realtime shadows. had been purged.

1659627972140.png

1659628051730.png

As for the strange behaviour of in-page cross-section links, I do have the same trouble. Click the link of 从Spine导出文件到Unity do not scroll to the right section.

Screen_2022-08-05_00-01-34.zip

if the suffix of link (#从Spine导出文件到Unity) caused encoding problem? my edge browser show the URL like this:

http://esotericsoftware.com/spine-unity-zh#%E4%BB%8ESpine%E5%AF%BC%E5%87%BA%E6%96%87%E4%BB%B6%E5%88%B0Unity

[Harald]

I compared the present translation for Spine/Sprite/Pixel Lit and Universal Render Pipeline/Spine/Sprite with diffs, the excrescent sentences The only shader that receives per-pixel realtime shadows. and Receives per-pixel realtime shadows. had been purged.

Oh I see, sorry, I didn't notice that the initial diff I have posted was in the wrong order of commits (I've confused "diff @~1 @" with "diff @ @~1"), so it incorrectly showed addition as removal . The unified diff showed the sentences correctly as added.

As for the strange behaviour of in-page cross-section links, I do have the same trouble. Click the link of 从Spine导出文件到Unity do not scroll to the right section.

Thanks for testing the link with your browser, good to see this issue confirmed.
[Edit:]
Misaki pointed out that references on the Japanese spine-unity page require an additional prefix to work for strange reasons: when adding /spine-unity in front (/spine-unity#从Spine导出文件到Unity) it works as intended. So the format /spine-unity#heading-title shall be used for cross-section references from now on.
For example, a markdown link in the .md file will look like this:

[从Spine导出文件到Unity](/spine-unity#从Spine导出文件到Unity)

And with full text

请确保你的atlas文件的扩展名为.atlas.txt而非.atlas. 详见[从Spine导出文件到Unity](/spine-unity#从Spine导出文件到Unity).

[wiige]

Nice ! I left cross-section links untouched when I translated spine-unity documentation before. It may take more time and patient to allow me correct every link so that they can locate the right section. It will be upadted ASAP.

Misaki pointed out that references on the Japanese spine-unity page require an additional prefix to work for strange reasons: when adding /spine-unity in front (/spine-unity#从Spine导出文件到Unity) it works as intended. So the format /spine-unity#heading-title shall be used for cross-section references from now on.

here is an uncertainty perplex me: Japanese spine-unity page can be accessed by both spine-unity-ja URL and spine-unity URL, and own multiple variations of cross-section links:

「[マテリアル](#%E3%83%9E%E3%83%86%E3%83%AA%E3%82%A2%E3%83%AB)」

,

[Unity向けのバイナリエクスポート](/spine-unity-ja#Unity向けのバイナリエクスポート)

and

「[SkeletonGraphicコンポーネント - CanvasGroupアルファ](/spine-unity#CanvasGroupアルファ)」

, they locate sections correctly , scrolling well.

1659745151750.png

1659744285016.png

1659744317372.png

So, what's the proper form of those links allow them work as intended? And please let me know which one can be the best style ? :

[从Spine导出文件到Unity](/spine-unity#从Spine导出文件到Unity)

[从Spine导出文件到Unity](/spine-unity-zh#从Spine导出文件到Unity)

[从Spine导出文件到Unity](/spine-unity-zh#%E4%BB%8ESpine%E5%AF%BC%E5%87%BA%E6%96%87%E4%BB%B6%E5%88%B0Unity(Character In Hex byte with GB2312))

Looking forward to your advices sincerely

---

minor update for per-pixel realtime shadows notification:

[Update]spine-unity-zh_CN-per-pixel_realtime_shadows.zip

[Nate]

@wiige, please check your email.

[Harald]

Thanks @wiige for all your efforts! Your latest changes have been integrated:
spine-unity 运行时文档

So, what's the proper form of those links allow them work as intended? And please let me know which one can be the best style ? :

Please use the style without the -zh suffix, so please use this one (first in your list):

[从Spine导出文件到Unity](/spine-unity#从Spine导出文件到Unity)

The -zh or -ja suffix references should actually never be used anywhere, we have corrected the Japanese translation. Thanks for reporting!

[wiige]

@wiige, please check your email.

sure!

---

Please use the style without the -zh suffix, so please use this one (first in your list):

[从Spine导出文件到Unity](/spine-unity#从Spine导出文件到Unity)

The -zh or -ja suffix references should actually never be used anywhere, we have corrected the Japanese translation. Thanks for reporting!

Great to hear that! And I updated my ToDo list,
Here is my New Translation To-Do List:

• ☑ spine-unity Runtime Documentation in-page links Update (100%)
  spine-unity_zh_link_update.zip
• □ spine-c Runtime Documentation (WIP, 20%)
• □ spine-cpp Runtime Documentation (WIP, 60%)
• □ spine-ue4 Runtime Documentation (WIP, 35%)

[Harald]

Great! Thanks for all your hard work!

[wiige]

I have finished the update of cross-link in spine-unity documentation :

spine-unity_zh_link_update.zip

BTW, I found two failed in-page links at line 2270 and 2262:

6c5ad470d6627ddea54633ba5993453.jpg

1660260135297.png

it made me feel that link

[Spine AnimationState Track](/spine-unity#Spine-AnimationState-Track)

failed because there exist no section called "Spine AnimationState Track" anymore, need to be correct

BTW2:
I put some labels of translation in the section title(for disambiguation) that made it brackets included.
Shall I decorate any escape character before brackets contained in the cross-link to let markdown parse normally?

Please give me your advices.

[Harald]

Wow, that was super quick! Thanks so much for this big update, and for reporting the two broken Timeline links!


We have integrated all your changes on the documentation page:
zh.esotericsoftware.com/spine-unity
Regarding using brackets: all seems to be fine, I could not find any problems. It should be safe to use brackets, even text like [code] will work unless the closing tag [/code ] is found following it.

I have a also fixed the two Timeline links in the Chinese page to point to the correct section now ("SkeletonAnimation-Track-与-SkeletonGraphic-Track"), and one link that was missing a dash -, the diff can be found here:
https://diffy.org/diff/c81afe813bc5b

In case I messed anything up, please let me know, I will of course be happy to fix it!
Thanks again for your great contributions!

[wiige]

Nice! I have a translation update about the note of BlendModeMaterialsAsset here :

[ZH]spine-unity-doc_BlendModeMaterialsAsset_Note.zip

[Harald]

Thanks very much for the update! We have integrated your changes.

---

FYI: We have added some more additions and corrections to the spine-unity documentation page:
https://diffy.org/diff/cd7b37f689b3b
Please note that we have previously added a short remark in two locations of the Chinese spine-unity page ourself, simple added code comments: // skeletonMecanim.Update() for SkeletonMecanim. So please be sure to base any modifications on the updated page.

[wiige]

I have finished the update of changes in spine-unity documentation :

[ZH_CN]spine_unity.zip

[Harald]

Thanks very much for the update, always much appreciated! We have updated the documentation page accordingly.

---

FYI: We have uploaded yet another update regarding the documentation pages, this time spine-unity-events:
https://diffy.org/diff/05cd88bd40e4b

[wiige]

OK, will update it ASAP

---

Done , here it is:

[UPDATE][ZH_CN]Spine Events and AnimationState callbacks.zip

[Harald]

Thanks very much for the update! We have updated the documentation page accordingly.

---

FYI: We have added a section about the recently published Import Troubleshooting video to the spine-unity documentation page:
https://diffy.org/diff/88ed22b04080d
The text in both sections is identical.

[wiige]

nice timing! I am finishing the tanslation [ZH_CN]spine_unity_cpp.
I will combine these two in the new TODO list ASAP.

----
Done!

• ☑ spine-unity Runtime Documentation (Done, 100%)
  [ZH_CN]spine-unity 运行时文档_Add Troubleshooting Video.zip
• □ spine-c Runtime Documentation (WIP, 20%)
• ☑ spine-cpp Runtime Documentation (Finishing, 100%)
• □ spine-ue4 Runtime Documentation (WIP, 35%)

[Harald]

Wow, that was amazingly quick!! Thanks a lot!
We have just updated the Chinese spine-unity documentation page with your additions.

[wiige]

spine-cpp Runtime Documentation translation complete, here is the update of TODO list:

• ☑ spine-unity Runtime Documentation (Done, 100%)
  [ZH_CN]spine-unity 运行时文档_Add Troubleshooting Video.zip
• □ spine-c Runtime Documentation (WIP, 20%)
• ☑ spine-cpp Runtime Documentation (Done, 100%)
  [ZH_CN]spine_unity_cpp.zip
• □ spine-ue4 Runtime Documentation (WIP, 35%)

After I check the spine-cpp Runtime Documentation, the update of spine-unity Runtime Documentation which mainly about Youtube links addition made me talk. I guess Chinese users may never visit the FAQ video concerning import problem since Youtube page cannot be legally viewed by most Chinese users.
Is there any way replace those two helpful Youtube links with other video source that own more accessibility for Chinese user? May be Acfun/Bilibili/iQiYi/Youku links or something else?

[Misaki]

You are definitely right! I uploaded the Import Troubleshooting video to bilibili and would like to embed this in the Chinese documentation:
https://www.bilibili.com/video/BV1BD4y1Y7By/

[wiige]

You are definitely right! I uploaded the Import Troubleshooting video to bilibili and would like to embed this in the Chinese documentation:
https://www.bilibili.com/video/BV1BD4y1Y7By/

that sounds good but there exist no share button for me. how do I get the iframe code to embed this video into document?

1670339261433.png

Please help me with this