wikisrc/htdocs_migration.mdwn - view

File: [NetBSD Developer Wiki] / wikisrc / htdocs_migration.mdwn
Revision 1.2: download - view: text, annotated - select for diffs
Sun Dec 16 20:41:23 2012 UTC (8 years, 1 month ago) by jdf
Branches: MAIN
CVS tags: HEAD

Fix markup (a code block needs a prepended blank line)

1: # Migraton from htdocs to the wiki 2: There are several reasons people want away from the current htdocs system. 3: The main part is that its structure made in docbook is difficult to maintain, 4: and user contributions are nearly impossible. 5: Thus, the plan is to migrate the website to the wiki, from docbook to markdown. 6: This cannot be done automatically, the sites have to be reviewed before entering 7: them in markdown, and the links have to be corrected. 8: 9: If you want to participate, just have a look at the not-yet transformed articles 10: and transfer them. If you need access to a working wiki, write a mail to jdf@ 11: with your mail-address and username and you will be granted access to the GCi 12: wiki. 13: 14: ## How htdocs is organized 15: You can check out the current htdocs tree with CVS from any NetBSD CVS server 16: just by checking out `htdocs`. 17: 18: There are 187 `index.html` in the current htdocs, which means there are 187 19: primary topics with subpages. 20: 21: ## Migration plan 22: The current plan is just to move the files to markdown and the wiki, and then 23: link on the website via .htaccess to the new wiki articles. 24: The old website should then be statically available at some location. 25: 26: It's still questionable whether the whole website has to be transferred 27: one-to-one, or whether we should take the chance to review all the content, 28: which might take up very long and is not possible without further coordination 29: of all developers, esp. for the port maintainers. 30: 31: The articles which clearly have to be transferred are the ones in the `/docs` 32: and the `/ports` hierarchy. For the other ones, as well as the dynamically 33: generated content like the `/changes`, special care has to be taken whether they 34: should be migrated and if so, the generating scripts have to be modified. 35: 36: The files in the `/images` subdirectory should be uploaded again, but their 37: usage has to be looked up. 38: 39: ## To be done 40: Those which are not yet transformed are these: 41: 42: ./index.html 43: ./about/index.html 44: ./changes/index.html 45: ./community/index.html 46: ./contrib/org/index.html 47: ./contrib/index.html 48: ./developers/index.html 49: ./developers/cvs-repos/index.html 50: ./developers/features/index.html 51: ./developers/pkgsrc/index.html 52: ./developers/releng/index.html 53: ./docs/Hardware/Busses/ADB/index.html 54: ./docs/Hardware/Busses/ATA/index.html 55: ./docs/Hardware/Busses/index.html 56: ./docs/Hardware/Busses/I2C/index.html 57: ./docs/Hardware/Busses/IEEE1394/index.html 58: ./docs/Hardware/Busses/MCA/index.html 59: ./docs/Hardware/Busses/Q-bus/index.html 60: ./docs/Hardware/Busses/SCSI/index.html 61: ./docs/Hardware/Busses/USB/index.html 62: ./docs/Hardware/Busses/VME/index.html 63: ./docs/Hardware/Busses/Zorro/index.html 64: ./docs/Hardware/index.html 65: ./docs/Hardware/Chips/DEC/index.html 66: ./docs/Hardware/Chips/index.html 67: ./docs/Hardware/Chips/HP/index.html 68: ./docs/Hardware/Chips/Intel/index.html 69: ./docs/Hardware/Chips/MIPS/index.html 70: ./docs/Hardware/Chips/Microchip/index.html 71: ./docs/Hardware/Chips/Motorola/index.html 72: ./docs/Hardware/Chips/NatSemi/index.html 73: ./docs/Hardware/Chips/TI/index.html 74: ./docs/Hardware/Machines/ARC/index.html 75: ./docs/Hardware/Machines/DEC/vax/index.html 76: ./docs/Hardware/Machines/DEC/index.html 77: ./docs/Hardware/Machines/index.html 78: ./docs/Hardware/Machines/Apollo/index.html 79: ./docs/Hardware/Machines/Apple/index.html 80: ./docs/Hardware/Machines/Commodore/index.html 81: ./docs/Hardware/Machines/HP/index.html 82: ./docs/Hardware/Machines/IBM/index.html 83: ./docs/Hardware/Machines/MacroSystem/index.html 84: ./docs/Hardware/Machines/Motorola/index.html 85: ./docs/Hardware/Machines/NeXT/index.html 86: ./docs/Hardware/Machines/PC532/index.html 87: ./docs/Hardware/Machines/Sun/index.html 88: ./docs/Hardware/Misc/index.html 89: ./docs/index.html 90: ./docs/bsd/lite2/index.html 91: ./docs/bsd/index.html 92: ./docs/bsd/net2/index.html 93: ./docs/cross/index.html 94: ./docs/kernel/profiling/index.html 95: ./docs/kernel/index.html 96: ./docs/kernel/pseudo/index.html 97: ./docs/misc/smbprint/index.html 98: ./docs/network/ipsec/index.html 99: ./docs/network/ipv6/index.html 100: ./docs/network/isdn/index.html 101: ./docs/network/netboot/rbootd/index.html 102: ./docs/network/netboot/index.html 103: ./docs/network/pppoe/index.html 104: ./docs/pkgsrc/index.html 105: ./docs/power-mgmt/index.html 106: ./docs/research/index.html 107: ./docs/rump/index.html 108: ./docs/software/index.html 109: ./donations/index.html 110: ./errors/index.html 111: ./foundation/index.html 112: ./foundation/press/index.html 113: ./gallery/advocacy/index.html 114: ./gallery/index.html 115: ./gallery/events/usenix2001/index.html 116: ./gallery/events/index.html 117: ./gallery/events/usenix2002/index.html 118: ./gallery/events/usenix2003/index.html 119: ./gallery/events/usenix2004/index.html 120: ./gallery/in-Action/index.html 121: ./gallery/presentations/index.html 122: ./gallery/xplanet/index.html 123: ./mailinglists/index.html 124: ./mirrors/torrents/index.html 125: ./mirrors/index.html 126: ./people/index.html 127: ./people/groups/index.html 128: ./ports/acorn26/index.html 129: ./ports/index.html 130: ./ports/acorn32/index.html 131: ./ports/algor/index.html 132: ./ports/alpha/index.html 133: ./ports/amiga/index.html 134: ./ports/amigappc/index.html 135: ./ports/arc/index.html 136: ./ports/arm/index.html 137: ./ports/arm26/index.html 138: ./ports/arm32/index.html 139: ./ports/atari/index.html 140: ./ports/bebox/index.html 141: ./ports/cats/index.html 142: ./ports/cesfic/index.html 143: ./ports/cobalt/index.html 144: ./ports/dreamcast/index.html 145: ./ports/emips/index.html 146: ./ports/evbsh3/index.html 147: ./ports/ews4800mips/index.html 148: ./ports/hp300/index.html 149: ./ports/hp700/index.html 150: ./ports/hpcmips/index.html 151: ./ports/hpcsh/index.html 152: ./ports/ia64/index.html 153: ./ports/ibmnws/index.html 154: ./ports/iyonix/index.html 155: ./ports/landisk/index.html 156: ./ports/luna68k/index.html 157: ./ports/mac68k/booter-manual/index.html 158: ./ports/mac68k/index.html 159: ./ports/mac68k/faq/index.html 160: ./ports/mac68k/info/index.html 161: ./ports/mac68k/theobald/index.html 162: ./ports/macppc/index.html 163: ./ports/macppc/SystemDisk-tutorial/index.html 164: ./ports/mipsco/index.html 165: ./ports/mmeye/index.html 166: ./ports/mvme68k/index.html 167: ./ports/mvmeppc/index.html 168: ./ports/netwinder/index.html 169: ./ports/news68k/index.html 170: ./ports/newsmips/index.html 171: ./ports/next68k/index.html 172: ./ports/ofppc/index.html 173: ./ports/pc532/index.html 174: ./ports/pdp10/index.html 175: ./ports/playstation2/index.html 176: ./ports/pmax/index.html 177: ./ports/pmppc/index.html 178: ./ports/prep/index.html 179: ./ports/rs6000/index.html 180: ./ports/s390/index.html 181: ./ports/sandpoint/index.html 182: ./ports/sbmips/index.html 183: ./ports/sgimips/index.html 184: ./ports/sh3/index.html 185: ./ports/shark/index.html 186: ./ports/sun2/index.html 187: ./ports/sun3/index.html 188: ./ports/vax/index.html 189: ./ports/x68k/index.html 190: ./ports/zaurus/index.html 191: ./releases/formal-0.8/index.html 192: ./releases/index.html 193: ./releases/formal-0.9/index.html 194: ./releases/formal-1.0/index.html 195: ./releases/formal-1.1/index.html 196: ./releases/formal-1.2/index.html 197: ./releases/formal-1.3/sun3x/index.html 198: ./releases/formal-1.3/index.html 199: ./releases/formal-1.4/index.html 200: ./releases/formal-1.5/index.html 201: ./releases/formal-1.6/index.html 202: ./releases/formal-2.0/index.html 203: ./releases/formal-3/index.html 204: ./releases/formal-4/index.html 205: ./releases/formal-5/index.html 206: ./releases/formal-6/index.html 207: ./releng/index.html 208: ./sites/index.html 209: ./support/hardware/index.html 210: ./support/index.html 211: ./support/security/index.html 212: 213: # Already done 214: Those are the index files already transformed by GCi students and not yet in the 215: wiki: 216: 217: ./docs/current/index.html 218: ./docs/network/nsps/index.html 219: ./docs/internals/en/index.html 220: ./ports/xen/index.html 221: ./docs/x/index.html 222: ./docs/misc/index.html 223: ./docs/puffs/index.html 224: ./docs/network/index.html 225: ./docs/guide/en/index.html 226: 227: Those are single files which were also done by GCi students: 228: 229: ./docs/bootcd.html 230: http://ftp.netbsd.org/pub/NetBSD/NetBSD-5.1.2/i386/INSTALL.html 231: ./docs/encrypted-iscsi.html 232: 233: Those are the ones already in the wiki: 234: 235: ./ports/amd64/index.html 236: ./ports/evbarm/index.html 237: ./ports/evbmips/index.html 238: ./ports/evbppc/index.html 239: ./ports/hpcarm/index.html 240: ./ports/i386/index.html 241: ./ports/sparc/index.html 242: ./ports/sparc64/index.html 243: ./ports/xen