https://fcitx-im.org/index.php?action=history&feed=atom&title=Create_a_new_Fcitx_Theme 2026-05-03T12:32:10Z Revision history for this page on the wiki MediaWiki 1.45.1 https://fcitx-im.org/index.php?title=Create_a_new_Fcitx_Theme&diff=45169&oldid=prev 2021-11-15T06:30:24Z

<p>Created page with &quot;&lt;languages /&gt; &lt;translate&gt; This page tends to describe how to create a new theme for Fcitx 5 Special:myLanguage/Theme Customization#Classic User interface|Classic User Inter...&quot;</p> <p><b>New page</b></p><div>&lt;languages /&gt;<br /> &lt;translate&gt;<br /> <br /> This page tends to describe how to create a new theme for Fcitx 5 [[Special:myLanguage/Theme Customization#Classic User interface|Classic User Interface]].<br /> <br /> = Required files =<br /> Files should be placed under &lt;code&gt;XDG_DATA_DIR/share/fcitx5/themes/[some directory]/&lt;/code&gt;. A good user level place is usually &lt;code&gt;~/.local/share/fcitx5/themes/&lt;/code&gt;.<br /> <br /> It need to contain a file &lt;code&gt;theme.conf&lt;/code&gt;. You may simply copy &lt;code&gt;theme.conf&lt;/code&gt; from default theme.<br /> <br /> You need to manually modify the name in a desktop-style field. Other than that, all other fields are accessible via [[Special:myLanguage/Configtool (Fcitx 5)|Configtool]].<br /> <br /> = Understand the rendering process =<br /> == The elements in the input popup window ==<br /> There are 3 single line text, Auxiliary Text Up, Preedit, Auxiliary Text Down, and a list of candidates in the window.<br /> <br /> Input popup has two different layout model, vertical and horizontal as shown in the table below.<br /> <br /> {| class=&quot;wikitable&quot;<br /> |+ Horizontal layout<br /> |-<br /> | Auxiliary Text Up<br /> | colspan=&quot;4&quot; | Preedit<br /> |-<br /> | Auxiliary Text Down || Candidate 1 || Candidate 2 || ... || Candidate n<br /> |}<br /> <br /> <br /> {| class=&quot;wikitable&quot;<br /> |+ Vertical layout<br /> |-<br /> | Auxiliary Text Up || Preedit<br /> |-<br /> | colspan=&quot;2&quot; | Auxiliary Text Down<br /> |-<br /> | colspan=&quot;2&quot; | Candidate 1<br /> |-<br /> | colspan=&quot;2&quot; | Candidate 2<br /> |- <br /> | colspan=&quot;2&quot; | ... <br /> |- <br /> | colspan=&quot;2&quot; | Candidate n<br /> |}<br /> <br /> The context with in the table are laid out side by side. You may think of them wrapped by a text box, with text margin around the text.<br /> <br /> The whole context with in the popup are wrapped as a big box, with context margin around the text.<br /> <br /> <br /> = Some idea about creating a theme with irregular shape =<br /> <br /> &lt;/translate&gt;</div>

Weng Xuetian