((META (EMPTY-STRING title "Configure memory boxes") (WORD role "manual") (TAG-SET tags ("#configuration" "#manual" "#zettelstore")) (WORD syntax "zmk") (ZID-SET back ("00001004011200")) (ZID-SET backward ("00001004011200")) (NUMBER box-number "1") (STRING copyright "(c) 2020-present by Detlef Stern <ds@zettelstore.de>") (TIMESTAMP created "20220307112918") (WORD lang "en") (EMPTY-STRING license "EUPL-1.2-or-later") (TIMESTAMP modified "20250627155851") (TIMESTAMP published "20250627155851") (WORD visibility "public")) (BLOCK (PARA (TEXT "Under most circumstances, it is preferable to further configure a memory box.") (SOFT) (TEXT "This is done by appending query parameters after the base box URI ") (LITERAL-INPUT () "mem:") (TEXT ".")) (PARA (TEXT "The following parameters are supported:")) (TABLE ((CELL ((align . "center")) (TEXT " Parameter")) (CELL () (TEXT "Description")) (CELL ((align . "center")) (TEXT "Default value")) (CELL ((align . "center")) (TEXT "Maximum value"))) ((CELL ((align . "center")) (TEXT "max-bytes")) (CELL () (TEXT "Maximum number of bytes the box will store")) (CELL ((align . "center")) (TEXT "65535")) (CELL ((align . "center")) (TEXT "1073741824 (1 GiB)"))) ((CELL ((align . "center")) (TEXT "max-zettel")) (CELL () (TEXT "Maximum number of zettel")) (CELL ((align . "center")) (TEXT "127")) (CELL ((align . "center")) (TEXT "65535")))) (PARA (TEXT "The default values are somewhat arbitrary but applicable to many use cases.")) (PARA (TEXT "While the number of zettel should be easily calculable by a user, the number of bytes might be a bit more difficult to determine.")) (PARA (TEXT "Metadata consumes 6 bytes for the zettel identifier, plus one byte for the separator for each metadata value, in addition to the length of the key and data.") (SOFT) (TEXT "The size of the content is its size in bytes. For text content, this corresponds to the number of bytes in its UTF-8 encoding.")) (PARA (TEXT "If one of the limits is exceeded, Zettelstore will return an error indicated by the HTTP status code 507."))))