aboutsummaryrefslogtreecommitdiff
path: root/README
blob: 299f3f3c33a23bea45d1372a5ab8f2fe4fb57e3f (plain) (blame)
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
Attempts to convert Permatrac Wiki to Markdown format.

Last time I had to do something like this it looks like I took the
Trac -> HTML -> html2markdown path.  Could do that again.  Recipe for
fetching the HTML:

     wget -r --user=sra@hactrn.net --ask-password https://permatrac.noc.ietf.org/wiki/

Slightly better recipe:

     wget -m -R '*[?]*' --user=sra@hactrn.net --ask-password https://permatrac.noc.ietf.org/wiki/

But either way, `wget` seems to be non-terminating when walking this
site, even if it throws away .999 of what it retrieves.  In theory,
adding `-np` would have fixed this; in practice doing so causes it not
to recurse at all.  Grrr.

Scripts from rpki.net/doc/*/*.{sh,py,xsl}, included here under tools/.

The other approach is converting Trac wiki directly to markdown.
There are hacks for this, in Ruby:

  https://gist.github.com/somebox/619537

But there are also Python versions, which are a bit more tractible.
Several of them included in tools/ too.


The most promising approach looks to be `tools/trac2md.py`, which is a
bit crude but is written in a relatively sane style so should be fixable.


Pelican content format: https://docs.getpelican.com/en/latest/content.html
.o mgmt-cli.o mgmt-dfu.c mgmt-fpga.c mgmt-misc.c mgmt-show.c mgmt-test.c mgmt-keystore.o BOARD_OBJS = \ $(TOPLEVEL)/stm-init.o \ $(TOPLEVEL)/stm-fmc.o \ $(TOPLEVEL)/stm-uart.o \ $(TOPLEVEL)/syscalls.o \ $(TOPLEVEL)/stm-rtc.o \ $(TOPLEVEL)/spiflash_n25q128.o \ $(TOPLEVEL)/stm-fpgacfg.o \ $(TOPLEVEL)/stm-keystore.o \ $(TOPLEVEL)/stm-sdram.o \ $(TOPLEVEL)/stm-flash.o \ $(BOARD_DIR)/TOOLCHAIN_GCC_ARM/startup_stm32f429xx_rtos.o \ $(BOARD_DIR)/system_stm32f4xx.o \ $(BOARD_DIR)/stm32f4xx_hal_msp.o \ $(BOARD_DIR)/stm32f4xx_it_rtos.o CFLAGS += -I$(LIBCLI_SRC) -I$(LIBHAL_SRC) CFLAGS += -I$(RTOS_DIR)/rtos -I$(RTOS_DIR)/rtx/TARGET_CORTEX_M LIBS += $(LIBCLI_BLD)/libcli.a $(LIBHAL_BLD)/libhal.a $(RTOS_DIR)/librtos.a all: $(TEST:=.elf) %.elf: %.o $(BOARD_OBJS) $(OBJS) $(LIBS) $(CC) $(CFLAGS) $^ -o $@ -T$(LDSCRIPT) -g -Wl,-Map=$*.map $(OBJCOPY) -O binary $*.elf $*.bin $(SIZE) $*.elf clean: rm -f *.o rm -f *.elf rm -f *.bin rm -f *.map