diff --git a/chapters/deploy.tex b/chapters/deploy.tex deleted file mode 100644 index e52a19e..0000000 --- a/chapters/deploy.tex +++ /dev/null @@ -1,36 +0,0 @@ -\chapter{部署} - -\section{Clone(克隆)Git 仓库} - -使用 git clone 命令,如下: - -\lstset{language = bash, style = lgeneral} - -\begin{lstlisting} - $ git clone https://git.thehrz.net/thehrz/yigedinglia.git && cd yigedinglia -\end{lstlisting} - -由于于网络原因,此步骤可能十分缓慢或失败。 - -\section{Docker Compose 部署} - -\lstset{language = bash, style = lgeneral} - -\begin{lstlisting} - $ docker compose up --build -d -\end{lstlisting} - -由于于网络原因,此步骤可能十分缓慢或失败。 - -\section{测试服务器} - -本项目也提供一个测试服务器,包含所有功能,欢迎使用。由于部署于中国香港,在中国大陆访问响应时间较长。如图 \ref{fig:ping}。 - -\begin{figure}[H] - \centering - \includegraphics[width=8cm]{ping.png} - \caption{} - \label{fig:ping} -\end{figure} - -地址: \href{https://yigedinglia.thehrz.net/}{https://yigedinglia.thehrz.net/} \ No newline at end of file diff --git a/chapters/frontend.tex b/chapters/frontend.tex deleted file mode 100644 index a9b5a80..0000000 --- a/chapters/frontend.tex +++ /dev/null @@ -1,60 +0,0 @@ -% !TeX root = ../main.tex - -\chapter{前端展示} - -\section{简介} - -基于 TypeScript 的 Vite + Vue.js 3 项目,使用 Navie UI 组件库。 - -\section{路由列表} - -\begin{itemize} - \item / - \item /idioms/solitaire - \item /idioms/:idiom - \item /data -\end{itemize} - -\section{主界面 / 查询界面} - -主界面即成语成语界面,输入一个成语并选择,转到成语详细页面。如图\ref{fig:index-page}。 - -\begin{figure}[H] - \centering - \includegraphics[width=13cm]{index-page.png} - \caption{} - \label{fig:index-page} -\end{figure} - -\subsection{成语输入} - -支持自动补全。如图\ref{fig:index-input}。 - -\begin{figure}[H] - \centering - \includegraphics[width=13cm]{index-input.png} - \caption{} - \label{fig:index-input} -\end{figure} - -\subsection{成语信息} - -包含成语含义、出处、例句。如图\ref{fig:idiom-detail}。 - -\begin{figure}[H] - \centering - \includegraphics[width=13cm]{idiom-detail.png} - \caption{} - \label{fig:idiom-detail} -\end{figure} - -\section{成语接龙} - -输入一个成语或点击“随机”按钮,自动查询成语,展示接龙。如图\ref{fig:soliaire}。 - -\begin{figure}[H] - \centering - \includegraphics[width=13cm]{soliaire.png} - \caption{} - \label{fig:soliaire} -\end{figure} diff --git a/chapters/intro.tex b/chapters/intro.tex index 45b3a51..3cac43f 100644 --- a/chapters/intro.tex +++ b/chapters/intro.tex @@ -16,7 +16,9 @@ 成语是我国汉语词汇里浓墨重彩的一笔,本应用有利于增添成语学习的趣味性,激发使用者对文学和语言的兴趣,提升使用者对成语典故的理解和运用能力,使其通过成语了解和传承中华民族的民族心理、民族文化和历史走向。 -整个研发过程让开发者的创造性思维得以展现,从分析研究成语的特点,到开发成语接龙的高效算法,我们注重思维的碰撞,小组成员进行了大量研究。同时,小组成员通过该项活动把日常学习生活中的所思所感融会贯通,展示了自己的想法和风格,实现了自我表达。 +整个研发过程让开发者的创造性思维得以展现,从分析研究成语的特点,到开发成语接龙的高效算法,我们注重思维的碰撞,小组成员进行了大量研究。 + +小组成员通过该项活动把日常学习生活中的所思所感融会贯通,展示了自己的想法和风格。 \section{关于“一个顶俩”} diff --git a/chapters/process.tex b/chapters/process.tex deleted file mode 100644 index 54d636d..0000000 --- a/chapters/process.tex +++ /dev/null @@ -1,224 +0,0 @@ -% !TeX root = ../main.tex - -\lstdefinestyle{lfonts}{ - basicstyle = \scriptsize\ttfamily, - stringstyle = \color{purple}, - keywordstyle = \color{blue!60!black}\bfseries, - commentstyle = \color{olive}\scshape, -} -\lstdefinestyle{lnumbers}{ - numbers = left, - numberstyle = \tiny, - numbersep = 1em, - firstnumber = 1, - stepnumber = 1, -} -\lstdefinestyle{llayout}{ - breaklines = true, - tabsize = 2, - % columns = spacefixed, -} -\lstdefinestyle{lgeometry}{ - xleftmargin = 20pt, - xrightmargin = 0pt, - frame = tb, - framesep = \fboxsep, - framexleftmargin = 20pt, -} - -\lstdefinestyle{lgeneral}{ - style = lfonts, - style = lnumbers, - style = llayout, - style = lgeometry, -} - -\lstdefinelanguage{JavaScript}{ - keywords={typeof, new, true, false, catch, function, return, null, catch, switch, var, if, in, while, do, else, case, break, import, const, from}, - keywordstyle=\color{blue}\bfseries, - ndkeywords={class, export, boolean, throw, implements, import, this}, - ndkeywordstyle=\color{darkgray}\bfseries, - identifierstyle=\color{black}, - sensitive=false, - comment=[l]{//}, - morecomment=[s]{/*}{*/}, - commentstyle=\color{purple}\ttfamily, - stringstyle=\color{red}\ttfamily, - morestring=[b]', - morestring=[b]" -} - - -\chapter{成语接龙算法流程} - -\section{成语词库} - -我们站在巨人的肩膀上,前人已经收集了足够的成语词库。成语词库来源于 \href{https://github.com/pwxcoo/chinese-xinhua}{chinese-xinhua},此项目以 MIT 协议开源。 - -以下是其中一个成语的数据结构: - -\lstset{language = JavaScript, style = lgeneral} - -\begin{lstlisting} -{ - "derivation": "语出《法华经·法师功德品》下至阿鼻地狱。”", - "example": "但也有少数意志薄弱的……逐步上当,终至堕入~。★《上饶集中营·炼狱杂记》", - "explanation": "阿鼻梵语的译音,意译为无间”,即痛苦无有间断之意。常用来比喻黑暗的社会和严酷的牢狱。又比喻无法摆脱的极其痛苦的境地。", - "pinyin": "ā bí dì yù", - "word": "阿鼻地狱", - "abbreviation": "abdy", - "id": 0 -}, -\end{lstlisting} - -经统计,共收录了 30895 个成语,但其中还包括了非四字成语。我们使用如下 JavaScript 代码剔除: - -\lstset{language = JavaScript, style = lgeneral} - -\begin{lstlisting} -import fs from 'node:fs' -import path from 'node:path' - -import idioms from './idiom.json' assert { type: 'json' } - -const new_idioms = idioms.filter(value => value.word.length === 4) - -console.log(new_idioms.length) - -const idioms_json = JSON.stringify(new_idioms) - -fs.writeFile('./four_letter_idioms.json', idioms_json, (err) => { - if (err) - throw err -}) -\end{lstlisting} - -\section{后端} - -\subsection{索引} -为便于查询成语,首先为每个成语以其首拼音和末拼音索引。 - -再采用递推法,以成语“一个顶俩”的“yi”为初始值,遍历末拼音为“yi”的成语,以第一次循环为“第一层”,为每个成语添加层级属性。 - -以下为核心代码: - -\lstset{language = Go, style = lgeneral} - -\begin{lstlisting} -func initIdiomsDB() { - lastPinyins := mapset.NewSet[string]() - - lastPinyins.Add("yi") // 初始化,以“yi”为起点递推 - - level := 1 - for lastPinyins.Cardinality() > 0 { // 直到无需要遍历的拼音结束循环 - firstPinyins := mapset.NewSet[string]() - - for pinyin := range lastPinyins.Iter() { - err := func() error { - txn := IdiomsDB.Txn(true) - defer txn.Abort() - - result, err := txn.Get("lastPinyin", "pinyin", pinyin) - if err != nil { - return err - } - - for item := result.Next(); item != nil; item = result.Next() { - lastPinyin := item.(*models.LastPinyin) - if lastPinyin != nil && level > 0 { - if lastPinyin.Idiom.Level == 0 { - lastPinyin.Idiom.Level = level - err := txn.Insert("idioms", lastPinyin.Idiom) - if err != nil { - return err - } - firstPinyins.Add(utils.GetFirstPinyin(lastPinyin.Idiom.Pinyin)) - } - } - } - txn.Commit() - return nil - }() - if err != nil { - log.Fatal(err) - } - } - - lastPinyins = firstPinyins // 以在下一次循环查询成语 - level++ - } -} -\end{lstlisting} - -本算法实际上是递推思想的应用。算法前期对成语索引,为每个成语添加Level属性,以便于之后的正向查询成语接龙。 - -以下为流程图: - -\begin{figure}[H] - \centering - \includegraphics[width=12cm]{index.pdf} - \caption{} - \label{fig:index} -\end{figure} - -\subsection{遍历查询} - -得到这些成语后再分别遍历以每个成语首拼音为末拼音的成语。 - -以下为核心代码: -\lstset{language = Go, style = lgeneral} - -\begin{lstlisting} -func Solitaire(c echo.Context) error { - var r *solitaireRequest - err := c.Bind(&r) - if err != nil { - return c.String(http.StatusBadRequest, "") - } - idiom, err := db.GetIdiom(r.Word) - if err != nil { - return c.String(http.StatusBadRequest, "") - } - - idioms := linkedhashset.New() - - for idiom != nil { - idioms.Add(idiom) - level := idiom.Level - if level > 1 { - pinyinIdioms, err := db.GetFirstPinyinIdioms(utils.GetLastPinyin(idiom.Pinyin)) - if err != nil { - return err - } - filtered := utils.Filter(pinyinIdioms, func(i *models.Idiom) bool { - return i.Level < idiom.Level - }) // 检出比当前成语低Level的成语 - idiom = utils.RandomItem(filtered) // 成语可能不止一个,随机取一个 - } else if utils.GetLastPinyin(idiom.Pinyin) == "yi" { - idioms.Add(&models.Idiom{ // 遍历结束,加一个顶俩 - Data: models.Data{ - Id: 29502, - Derivation: "无", - Example: "董同学在项目中起到了~的效果。", - Explanation: "形容一个人做事有效果,一个人能代替两个人。", - Pinyin: "yī gè dǐng liǎ", - Word: "一个顶俩", - Abbreviation: "无", - }, - }) - break - } else { - return c.String(http.StatusNoContent, "") // 找不到成语 - } - } - - return c.JSON(http.StatusOK, idioms) // 成功,输出 -} -\end{lstlisting} - -经过测试,循环遍历5次后需要遍历的成语列表为空,即最多4个成语就能到达“一个顶俩”这一成语。 - -每个成语的Level属性接龙到成语“一个顶俩”的“距离”。 - -在得到目标成语后,只需查询首拼音与该成语末拼音相同的成语中比该成语层级属性更低的成语,就能保证查询的方向是在步步逼近成语“一个顶俩”。 \ No newline at end of file diff --git a/chapters/test.tex b/chapters/test.tex deleted file mode 100644 index fe02070..0000000 --- a/chapters/test.tex +++ /dev/null @@ -1,32 +0,0 @@ -\chapter{基准测试} - -\section{Go Test} - -我们使用 Go Test 工具对成语接龙算法进行基准测试,结果如下: - -\lstset{language = Bash, style = lgeneral} - -\begin{lstlisting} -goos: linux -goarch: amd64 -pkg: yigedinglia-backend -cpu: 13th Gen Intel(R) Core(TM) i5-13400F -BenchmarkSolitaire -BenchmarkSolitaire-16 114219 8939 ns/op -PASS -\end{lstlisting} - -结果十分喜人,代表在最理想情况下,一次接龙操作耗时 8939 ns。 - -\section{Postman} - -实际的生产环境不总是最理想的,以下为 Postman 的压力测试报告: - -\begin{figure}[H] - \centering - \includegraphics[width=12cm]{postman.pdf} - \caption{} - \label{fig:postman} -\end{figure} - -报告显示,每秒能处理20.16个请求,平均每个请求耗时3ms。 \ No newline at end of file diff --git a/figures/idiom-detail.png b/figures/idiom-detail.png deleted file mode 100644 index 2c077fb..0000000 Binary files a/figures/idiom-detail.png and /dev/null differ diff --git a/figures/index-input.png b/figures/index-input.png deleted file mode 100644 index 192ccb1..0000000 Binary files a/figures/index-input.png and /dev/null differ diff --git a/figures/index-page.png b/figures/index-page.png deleted file mode 100644 index f5783c7..0000000 Binary files a/figures/index-page.png and /dev/null differ diff --git a/figures/index.pdf b/figures/index.pdf deleted file mode 100644 index 518f994..0000000 Binary files a/figures/index.pdf and /dev/null differ diff --git a/figures/ping.png b/figures/ping.png deleted file mode 100644 index 7437175..0000000 Binary files a/figures/ping.png and /dev/null differ diff --git a/figures/postman.pdf b/figures/postman.pdf deleted file mode 100644 index 4b9fac6..0000000 Binary files a/figures/postman.pdf and /dev/null differ diff --git a/figures/soliaire.png b/figures/soliaire.png deleted file mode 100644 index f42bcbd..0000000 Binary files a/figures/soliaire.png and /dev/null differ diff --git a/main.tex b/main.tex index c7a4fa5..074e917 100644 --- a/main.tex +++ b/main.tex @@ -7,10 +7,6 @@ \mainmatter \input{chapters/intro.tex} -\input{chapters/process.tex} -\input{chapters/frontend.tex} -\input{chapters/deploy.tex} -\input{chapters/test.tex} \backmatter \input{chapters/acknowledgements.tex} diff --git a/setup.tex b/setup.tex index b993216..29b1e3c 100644 --- a/setup.tex +++ b/setup.tex @@ -1,11 +1,11 @@ % !TeX root = ./main.tex \ustcsetup{ - title = {“一个顶俩”——基于Golang+Vue3的成语学习Web应用}, - class = {高一(12)班}, - author = {何锐哲\ 董子豪}, + title = {合肥市第八中学 LaTeX 论文模板}, + class = {高二(26)班}, + author = {何锐哲}, supervisor = {户雨}, - date = {2024-03-01}, + date = {2024-08-01}, math-font = xits, }