File:  [NetBSD Developer Wiki] / wikisrc / htdocs_migration.mdwn
Revision 1.4: download - view: text, annotated - select for diffs
Mon Dec 17 21:55:26 2012 UTC (7 years, 10 months ago) by wiki
Branches: MAIN
CVS tags: HEAD
web commit by mspo

    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: ## Semantical structure of the website
   39: As a wiki is potentially unordered while the website had a semantical structure,
   40: we need a structure also on the wiki. When migrating anyway, this would have to
   41: be reviewed.
   42: Current website structure:
   43: 
   44:  * about
   45:  * changes (automatically generated)
   46:  * community (only external links)
   47:  * contrib
   48:      * Organizations that contributed to NetBSD
   49:  * developers
   50:      * cvs-repos
   51:      * features
   52:      * pkgsrc
   53:      * releng
   54:  * docs
   55:      * Hardware
   56:          * Busses
   57:      * Chips
   58:      * Machines
   59:      * Misc
   60:      * psd, smm, usd
   61:      * Guide
   62:          * Installation guide
   63:          * Diverse information
   64:      * Internals guide
   65:      * Kernel
   66:      * misc
   67:         * smbprint
   68:      * network
   69:      * ipsec
   70:      * ipv6
   71:      * isdn
   72:      * netboot
   73:      * nsps
   74:      * pppoe
   75:      * pkgsrc Guide
   76:      * puffs
   77:      * rump
   78:      * research
   79:      * power-mgmt
   80:      * software
   81:  * foundation
   82:      * press
   83:      * reports
   84:          * financial
   85:      * resolutions
   86:  * gallery
   87:      * advocacy
   88:          * flyer
   89:      * sschumacher flyer
   90:      * events
   91:      * in-Action
   92:      * presentations
   93:      * press
   94:      * xplanet
   95:  * mirrors
   96:  * mailinglists
   97:  * people
   98:      * groups
   99:  * ports
  100:      * diverse ports
  101:  * releases
  102:      * diverse releases
  103:  * releng
  104:  * support
  105:      * hardware
  106:      * security
  107: 
  108: ## To be done
  109: Those which are not yet transformed are these:
  110: 
  111:     ./index.html
  112:     ./about/index.html
  113:     ./changes/index.html
  114:     ./community/index.html
  115:     ./contrib/org/index.html
  116:     ./contrib/index.html
  117:     ./developers/index.html
  118:     ./developers/cvs-repos/index.html
  119:     ./developers/features/index.html
  120:     ./developers/pkgsrc/index.html
  121:     ./developers/releng/index.html
  122:     ./docs/Hardware/Busses/ADB/index.html
  123:     ./docs/Hardware/Busses/ATA/index.html
  124:     ./docs/Hardware/Busses/index.html
  125:     ./docs/Hardware/Busses/I2C/index.html
  126:     ./docs/Hardware/Busses/IEEE1394/index.html
  127:     ./docs/Hardware/Busses/MCA/index.html
  128:     ./docs/Hardware/Busses/Q-bus/index.html
  129:     ./docs/Hardware/Busses/SCSI/index.html
  130:     ./docs/Hardware/Busses/USB/index.html
  131:     ./docs/Hardware/Busses/VME/index.html
  132:     ./docs/Hardware/Busses/Zorro/index.html
  133:     ./docs/Hardware/index.html
  134:     ./docs/Hardware/Chips/DEC/index.html
  135:     ./docs/Hardware/Chips/index.html
  136:     ./docs/Hardware/Chips/HP/index.html
  137:     ./docs/Hardware/Chips/Intel/index.html
  138:     ./docs/Hardware/Chips/MIPS/index.html
  139:     ./docs/Hardware/Chips/Microchip/index.html
  140:     ./docs/Hardware/Chips/Motorola/index.html
  141:     ./docs/Hardware/Chips/NatSemi/index.html
  142:     ./docs/Hardware/Chips/TI/index.html
  143:     ./docs/Hardware/Machines/ARC/index.html
  144:     ./docs/Hardware/Machines/DEC/vax/index.html
  145:     ./docs/Hardware/Machines/DEC/index.html
  146:     ./docs/Hardware/Machines/index.html
  147:     ./docs/Hardware/Machines/Apollo/index.html
  148:     ./docs/Hardware/Machines/Apple/index.html
  149:     ./docs/Hardware/Machines/Commodore/index.html
  150:     ./docs/Hardware/Machines/HP/index.html
  151:     ./docs/Hardware/Machines/IBM/index.html
  152:     ./docs/Hardware/Machines/MacroSystem/index.html
  153:     ./docs/Hardware/Machines/Motorola/index.html
  154:     ./docs/Hardware/Machines/NeXT/index.html
  155:     ./docs/Hardware/Machines/PC532/index.html
  156:     ./docs/Hardware/Machines/Sun/index.html
  157:     ./docs/Hardware/Misc/index.html
  158:     ./docs/index.html
  159:     ./docs/bsd/lite2/index.html
  160:     ./docs/bsd/index.html
  161:     ./docs/bsd/net2/index.html
  162:     ./docs/cross/index.html
  163:     ./docs/kernel/profiling/index.html
  164:     ./docs/kernel/index.html
  165:     ./docs/kernel/pseudo/index.html
  166:     ./docs/misc/smbprint/index.html
  167:     ./docs/network/ipsec/index.html
  168:     ./docs/network/ipv6/index.html
  169:     ./docs/network/isdn/index.html
  170:     ./docs/network/netboot/rbootd/index.html
  171:     ./docs/network/netboot/index.html
  172:     ./docs/network/pppoe/index.html
  173:     ./docs/pkgsrc/index.html
  174:     ./docs/power-mgmt/index.html
  175:     ./docs/research/index.html
  176:     ./docs/rump/index.html
  177:     ./docs/software/index.html
  178:     ./donations/index.html
  179:     ./errors/index.html
  180:     ./foundation/index.html
  181:     ./foundation/press/index.html
  182:     ./gallery/advocacy/index.html
  183:     ./gallery/index.html
  184:     ./gallery/events/usenix2001/index.html
  185:     ./gallery/events/index.html
  186:     ./gallery/events/usenix2002/index.html
  187:     ./gallery/events/usenix2003/index.html
  188:     ./gallery/events/usenix2004/index.html
  189:     ./gallery/in-Action/index.html
  190:     ./gallery/presentations/index.html
  191:     ./gallery/xplanet/index.html
  192:     ./mailinglists/index.html
  193:     ./mirrors/torrents/index.html
  194:     ./mirrors/index.html
  195:     ./people/index.html
  196:     ./people/groups/index.html
  197:     ./ports/acorn26/index.html
  198:     ./ports/acorn32/index.html
  199:     ./ports/algor/index.html
  200:     ./ports/alpha/index.html
  201:     ./ports/amiga/index.html
  202:     ./ports/amigappc/index.html
  203:     ./ports/arc/index.html
  204:     ./ports/arm/index.html
  205:     ./ports/arm26/index.html
  206:     ./ports/arm32/index.html
  207:     ./ports/atari/index.html
  208:     ./ports/bebox/index.html
  209:     ./ports/cats/index.html
  210:     ./ports/cesfic/index.html
  211:     ./ports/cobalt/index.html
  212:     ./ports/dreamcast/index.html
  213:     ./ports/emips/index.html
  214:     ./ports/evbsh3/index.html
  215:     ./ports/ews4800mips/index.html
  216:     ./ports/hp300/index.html
  217:     ./ports/hp700/index.html
  218:     ./ports/hpcmips/index.html
  219:     ./ports/hpcsh/index.html
  220:     ./ports/ia64/index.html
  221:     ./ports/ibmnws/index.html
  222:     ./ports/iyonix/index.html
  223:     ./ports/landisk/index.html
  224:     ./ports/luna68k/index.html
  225:     ./ports/mac68k/booter-manual/index.html
  226:     ./ports/mac68k/index.html
  227:     ./ports/mac68k/faq/index.html
  228:     ./ports/mac68k/info/index.html
  229:     ./ports/mac68k/theobald/index.html
  230:     ./ports/macppc/index.html
  231:     ./ports/macppc/SystemDisk-tutorial/index.html
  232:     ./ports/mipsco/index.html
  233:     ./ports/mmeye/index.html
  234:     ./ports/mvme68k/index.html
  235:     ./ports/mvmeppc/index.html
  236:     ./ports/netwinder/index.html
  237:     ./ports/news68k/index.html
  238:     ./ports/newsmips/index.html
  239:     ./ports/next68k/index.html
  240:     ./ports/ofppc/index.html
  241:     ./ports/pc532/index.html
  242:     ./ports/pdp10/index.html
  243:     ./ports/playstation2/index.html
  244:     ./ports/pmax/index.html
  245:     ./ports/pmppc/index.html
  246:     ./ports/prep/index.html
  247:     ./ports/rs6000/index.html
  248:     ./ports/s390/index.html
  249:     ./ports/sandpoint/index.html
  250:     ./ports/sbmips/index.html
  251:     ./ports/sgimips/index.html
  252:     ./ports/sh3/index.html
  253:     ./ports/shark/index.html
  254:     ./ports/sun2/index.html
  255:     ./ports/sun3/index.html
  256:     ./ports/vax/index.html
  257:     ./ports/x68k/index.html
  258:     ./ports/zaurus/index.html
  259:     ./releases/formal-0.8/index.html
  260:     ./releases/index.html
  261:     ./releases/formal-0.9/index.html
  262:     ./releases/formal-1.0/index.html
  263:     ./releases/formal-1.1/index.html
  264:     ./releases/formal-1.2/index.html
  265:     ./releases/formal-1.3/sun3x/index.html
  266:     ./releases/formal-1.3/index.html
  267:     ./releases/formal-1.4/index.html
  268:     ./releases/formal-1.5/index.html
  269:     ./releases/formal-1.6/index.html
  270:     ./releases/formal-2.0/index.html
  271:     ./releases/formal-3/index.html
  272:     ./releases/formal-4/index.html
  273:     ./releases/formal-5/index.html
  274:     ./releases/formal-6/index.html
  275:     ./releng/index.html
  276:     ./sites/index.html
  277:     ./support/hardware/index.html
  278:     ./support/index.html
  279:     ./support/security/index.html
  280: 
  281: # Already done
  282: Those are the index files already transformed by GCi students and not yet in the 
  283: wiki:
  284: 
  285:     ./docs/current/index.html
  286:     ./docs/network/nsps/index.html
  287:     ./docs/internals/en/index.html
  288:     ./ports/xen/index.html
  289:     ./docs/x/index.html
  290:     ./docs/misc/index.html
  291:     ./docs/puffs/index.html
  292:     ./docs/network/index.html
  293:     ./docs/guide/en/index.html
  294: 
  295: Those are single files which were also done by GCi students:
  296: 
  297:     ./docs/bootcd.html
  298:     http://ftp.netbsd.org/pub/NetBSD/NetBSD-5.1.2/i386/INSTALL.html
  299:     ./docs/encrypted-iscsi.html
  300: 
  301: Those are the ones already in the wiki:
  302: 
  303:     ./ports/amd64/index.html
  304:     ./ports/evbarm/index.html
  305:     ./ports/evbmips/index.html
  306:     ./ports/evbppc/index.html
  307:     ./ports/hpcarm/index.html
  308:     ./ports/i386/index.html
  309:     ./ports/sparc/index.html
  310:     ./ports/sparc64/index.html
  311:     ./ports/xen
  312:     ./ports/index.html

CVSweb for NetBSD wikisrc <wikimaster@NetBSD.org> software: FreeBSD-CVSweb