Skip to content

Commit

Permalink
docs: 增加歌词编辑器文档(感谢 @Xionghaizi001
Browse files Browse the repository at this point in the history
docs: 修正一些情况下的页面加载错误
  • Loading branch information
Steve-xmh committed Feb 2, 2024
1 parent f741f61 commit 4cddb86
Show file tree
Hide file tree
Showing 4 changed files with 44 additions and 9 deletions.
3 changes: 3 additions & 0 deletions packages/docs/src/app/[lang]/docs/[package]/[slug]/page.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -23,6 +23,9 @@ export async function generateStaticParams(): Promise<DocumationPageParam[]> {
const modules = await fs.readdir(path.resolve(docsPath));

for (const module of modules) {
if (await fs.stat(path.resolve(docsPath, module)).then((v) => !v.isDirectory())) {
continue;
}
const posts = await fs.readdir(path.resolve(docsPath, module));
// File name format: slug.lang.mdx
const distinctedPosts = [...new Set(posts.map((v) => v.split(".")[0]))];
Expand Down
5 changes: 4 additions & 1 deletion packages/docs/src/app/[lang]/docs/layout.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -24,7 +24,10 @@ async function loadAllPages() {
const modules = await fs.readdir(path.resolve(docsPath));
modules.sort();
for (const module of modules) {
const posts = await fs.readdir(path.resolve(docsPath, module));
if (await fs.stat(path.resolve(docsPath, module)).then((v) => !v.isDirectory())) {
continue;
}
const posts = (await fs.readdir(path.resolve(docsPath, module))).filter(v => v.endsWith(".mdx"));
posts.sort();
// File name format: slug.lang.mdx
const splitedPosts = posts.map((v) => v.split("."));
Expand Down
3 changes: 1 addition & 2 deletions packages/docs/src/docs/ttml-tools/tips.en-US.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,6 @@ title: Advanced Usage and Tips for TTML Editor
# Advanced Usage and Tips for TTML Editor

---
# *This article was translated by GPT and may contain grammatical or wording errors.*

### Before You Start
We assume that you have already read the [previous article](./introduction) and mastered the basic usage. In the following article, we will introduce some fancy tricks of the editor to you.
Expand Down Expand Up @@ -73,4 +72,4 @@ To achieve this is simple. You just need to do two things:

2. Proficiently use the `H` key to set the end marker.

As mentioned earlier, shortening the duration of certain words can create a pause that meets psychological expectations. Of course, we hope you can set pauses according to the rhythm of the music, which will make your lyrics more rhythmic.
As mentioned earlier, shortening the duration of certain words can create a pause that meets psychological expectations. Of course, we hope you can set pauses according to the rhythm of the music, which will make your lyrics more rhythmic.
42 changes: 36 additions & 6 deletions packages/docs/src/docs/ttml-tools/tips.zh-CN.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -33,7 +33,7 @@ title: 高级用法以及一些小技巧
- 你可以使用 **反斜杠(\)** 来手动划分单词


[![pFMberd.png](https://s11.ax1x.com/2024/02/01/pFMberd.png)](https://imgse.com/i/pFMberd)
[![pFQWEVO.png](https://s11.ax1x.com/2024/02/03/pFQWEVO.png)](https://imgse.com/i/pFQWEVO)


- 你可以使用 **行前缀** 来设定背景和对唱歌词
Expand All @@ -44,16 +44,26 @@ title: 高级用法以及一些小技巧
- ~~你可以使用一些符号来设置空拍。~~(即将上线,敬请期待)

- 你也可以把它们混着用。当然,请务必注意,对于一些无法翻译、没有实际意义的句子,或者没有相应内容的部分,
你仍然需要用一些什么东西把翻译行或者音译行占位,否则其它行会被导入到它们不该待着的位置。
你仍然需要用一些什么东西把翻译行或者音译行占位,或者干脆把它们空出来。否则其它行会被导入到它们不该待着的位置。

[![pFMLFje.png](https://s11.ax1x.com/2024/02/01/pFMLFje.png)](https://imgse.com/i/pFMLFje)

你可以按照你的需求或者喜好,在不影响程序正常运行的情况下,来修改这些具有特殊用途的控制符号。

通常我们会在外部文本编辑器(例如记事本)来预先设置好带有格式字符的歌词文本,通过启用相应的预处理功能,实现更加灵活与精确的文本导入。

对于英语、法语等一个词语有多个音节的情况,我们建议将这些词语按照音节进行分割,以及根据演唱者连读的情况来按需分割。这样可以尽可能地使歌词的展示效果与演唱效果更加接近,就像上文中的配图一样。

同时,如果歌词文本中包含标点符号,我们建议你将它们与最近的文字合并为一个单词,以节省打轴时的按键次数和提高打轴的精确度。
**如果你手速很快或者是《冰与火之歌》高阶玩家,那当我没说*
**如果你手速很快或者是《冰与火之舞》高阶玩家,那当我没说*

---

## 一些基本操作

- 打完了某一句,但是在检查时发现中间有一两个字打快了或者打慢了?
- 你可以重新对这一行歌词重新打轴,但我们更推荐:
**把光标移动到错误单词的上一个单词,然后在唱到错误单词时按下 `G` 键,这样就可以利用这一功能来无缝衔接两个单词,而不必重新对整行打轴。**

---

Expand All @@ -63,6 +73,10 @@ title: 高级用法以及一些小技巧

---

首先,一切演出效果均与单词的持续时长直接挂钩。所以,我们想要让播放器为你整一些花活,就需要在时间轴上做文章。下面的内容都是有关于如何利用时间轴的长短来让你的歌词看起来更加赏心悦目。

---

### 跟上节奏,燥起来!

通常,一份观感颇佳的歌词,需要从头到尾打轴两到三次:
Expand All @@ -74,9 +88,25 @@ title: 高级用法以及一些小技巧

想要做到这一点很简单,你只需要做两件事:

1. 对这首歌曲足够地熟悉,知道哪一段的伴奏音乐会有明显的节奏和停顿
1. 对这首歌曲足够地熟悉,知道哪一段的伴奏音乐和歌手演唱会有明显的节奏和停顿

2. 熟练地使用 `H` 键来设置结束标记。

因为上文中提到,缩短了某些单词的持续时间,可以获得一个符合心理预期的停顿。当然,我们更希望你能够按照音乐的节奏来设置停顿,
这样能够使你的歌词效果更加具有节奏感。
因为上文中提到,缩短了某些单词的持续时间,可以获得一个符合心理预期的停顿。当然,我们更希望你能够按照音乐的节奏来设置停顿,这样能够使你的歌词效果更加具有节奏感。

**你可以在我们的播放器内试听 [这首歌曲(02:16处)](https://music.163.com/song?id=2012691543)[这首歌曲(全曲)](https://music.163.com/song?id=354741&) 来理解上文提到的效果。*

---

### 温柔一点,慢下来。

对于一些叙事性很强的歌曲,它们通常节奏舒缓,唱词节奏比较长。这时候我们不必将每个字分隔为单词,而是根据演唱节奏适当增加单词长度,然后利用播放器的辉光效果来营造一种舒缓的观感。

想要做到这一点很简单,你仍然只需要做两件事:

1. 对这首歌曲足够地熟悉,了解歌手的演唱风格和这首歌曲的节奏;
2. 根据上一行中提到的要求,合理地分割单词。

**你可以在我们的播放器内试听 [这首歌曲]() 来理解本段提到的效果。*

### ****PS: 不要学Apple Music一样瞎分,那玩意在中国水土不服***

0 comments on commit 4cddb86

Please sign in to comment.