~strahinja/strahinja.srht.site

ref: a1bdc8f28beb6be015c9d41f1d86de79597f0a5c strahinja.srht.site/poe/index.slw -rw-r--r-- 3.0 KiB
a1bdc8f2Страхиња Радић Added .q/.a > ul formatting 2 months ago
                                                                                
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
---
site-name: poe - .po file editor
site-desc: .po file editor
stylesheet: /fonts.css
stylesheet: /index.css
stylesheet: /poe/poe.css
canonical: https://strahinja.srht.site/poe/
meta: index-meta.csv
---

{main}
# poe

**poe** is a .po (GNU gettext) file editor with a terminal UI.

## Q&A

{.qna}
{.q}
**Q:**Why?{/.q}
{.a}
**A:**{ul}{li}There should be no need for GNOME to edit .po files.{/li}
   {li}Some folks prefer terminal to GUI.{/li}
   {li}No, plugin for vi(m) isn't enough.{/li}{/ul}{/.a}

{.q}
**Q:**Why C?{/.q}
{.a}
**A:**Because `<Go/Rust/whatever soydev language of the moment>` sucks.{/.a}

{.q}
**Q:**Why is poe saying there are `<N+1>` messages in my file when other
editors say there are `<N>` messages?{/.q}
{.a}
**A:**Because poe takes into account (and allows editing of) the first,
   special msgid.{/.a}

{.q}
**Q:**This doesn't do X!{/.q}
{.a}
**A:**See TODO for a list of implemented and planned features. I might consider
adding a feature if I have time, but already poe has all the major ones I
planned. It is meant to be a simple .po editing program.{/.a}

{.q}
**Q:**Is this suckless?{/.q}
{.a}
**A:**Definitely not. Any TUI is not suckless. gettext is not suckless, and
thus .po files are also not suckless. Despite that, some suggestions for a
suckless approach to editing .po files are: vi, ed. Still, termbox, used by poe,
is less bloated than ncurses.{/.a}
{/.qna}


## Screenshots

### v0.5-alpha

[Screenshot 1][screen-0.5-01]  
[Screenshot 2][screen-0.5-02]

## Prerequisites

* C compiler (**GCC**-compatible) - `${POE_CC:-gcc}`
* **gzip**

## Install

```
$ git clone https://git.sr.ht/~strahinja/poe
$ cd poe
$ su
```

If you have djb redo:

```
# redo install
```

if you don't:

```
# ./do install
```

## Bugs and limitations

Bugs can be reported using the [ticket tracker][issue]. See the manpage (`man
poe`) after installing **poe** for more information.

## License

poe - .po file editor  
Copyright (C) 2021 Страхиња Радић

This program is free software: you can redistribute it and/or modify it under
the terms of the GNU General Public License as published by the Free Software
Foundation, either version 3 of the License, or (at your option) any later
version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with
this program. If not, see [https://www.gnu.org/licenses/][licen].

---

This program includes code from the termbox TUI library,

[https://github.com/termbox/termbox][termbox]

The file `LICENSE.termbox` applies to the portion of this program which is from
the termbox library.

{made-by}
{/main}

[issue]: https://todo.sr.ht/~strahinja/poe
[licen]: https://www.gnu.org/licenses
[termbox]: https://github.com/termbox/termbox
[screen-0.5-01]: /img/programi/poe-v0.5-001.webp
[screen-0.5-02]: /img/programi/poe-v0.5-002.webp