Go Back   vb.org Archive > vBulletin 3 Discussion > vB3 General Discussions
FAQ Community Calendar Today's Posts Search

Reply
 
Thread Tools Display Modes
  #1  
Old 07-03-2005, 09:37 PM
akanevsky akanevsky is offline
 
Join Date: Apr 2005
Posts: 3,972
Благодарил(а): 0 раз(а)
Поблагодарили: 0 раз(а) в 0 сообщениях
Default Hack Manual Generator

What do yall think about a thingy that would generate a pretty-looking HTML modification manuals (like the ones Logician makes) based on the input you put into the software. Why? Because most people make messy text-based manuals (inluding me), just because it takes too much time to hand-write an HTML-based manual.
Reply With Quote
  #2  
Old 07-03-2005, 09:39 PM
Andreas's Avatar
Andreas Andreas is offline
 
Join Date: Jan 2004
Location: Germany
Posts: 6,863
Благодарил(а): 0 раз(а)
Поблагодарили: 0 раз(а) в 0 сообщениях
Default

I prefer Textfiles, much easier to handle then HTML IMHO.

Just my 0,02 €
Reply With Quote
  #3  
Old 07-03-2005, 09:46 PM
amykhar's Avatar
amykhar amykhar is offline
 
Join Date: Oct 2001
Location: PA
Posts: 4,438
Благодарил(а): 0 раз(а)
Поблагодарили: 0 раз(а) в 0 сообщениях
Default

I hate html install instructions with a passion. I much prefer plain text.
Reply With Quote
  #4  
Old 07-03-2005, 09:49 PM
Paul M's Avatar
Paul M Paul M is offline
 
Join Date: Sep 2004
Location: Nottingham, UK
Posts: 23,748
Благодарил(а): 0 раз(а)
Поблагодарили: 0 раз(а) в 0 сообщениях
Default

html ones are fine, as long as you don't need to copy any code from them - that's a nightmare.
Reply With Quote
  #5  
Old 07-03-2005, 09:55 PM
akanevsky akanevsky is offline
 
Join Date: Apr 2005
Posts: 3,972
Благодарил(а): 0 раз(а)
Поблагодарили: 0 раз(а) в 0 сообщениях
Default

Quote:
Just my 0,02 €
Ouch! What can I do for 0,02 €??? I can't even buy myself an ice-cream. ://

Quote:
I hate html install instructions with a passion.
Why? Not that I want to prove you wrong (because I don't), I just wanna understand your point of view

Quote:
html ones are fine, as long as you don't need to copy any code from them - that's a nightmare.
How is that a nightmare? AFAIK, it is only a nightmare when you use wordpad. If you use something like a "Professional Notepad" or "Notepad++" or "UltraEdit32", you get no problem with formatted text, if that's what you talking about
Reply With Quote
  #6  
Old 07-03-2005, 10:00 PM
amykhar's Avatar
amykhar amykhar is offline
 
Join Date: Oct 2001
Location: PA
Posts: 4,438
Благодарил(а): 0 раз(а)
Поблагодарили: 0 раз(а) в 0 сообщениях
Default

Quote:
Originally Posted by Dark Visor
Ouch! What can I do for 0,02 €??? I can't even buy myself an ice-cream. ://


Why? Not that I want to prove you wrong (because I don't), I just wanna understand your point of view


How is that a nightmare? AFAIK, it is only a nightmare when you use wordpad. If you use something like a "Professional Notepad" or "Notepad++" or "UltraEdit32", you get no problem with formatted text, if that's what you talking about
Working from HTML install files isn't as easy as copying and pasting from text files. Plus, it means opening a bulky browser window instead of another tab in my text editor.

Amy
Reply With Quote
  #7  
Old 07-03-2005, 10:01 PM
tamarian tamarian is offline
 
Join Date: Oct 2001
Location: Canada
Posts: 1,205
Благодарил(а): 0 раз(а)
Поблагодарили: 0 раз(а) в 0 сообщениях
Default

I usually prefer that my hack's thread contains the detailed instructions, and some are quite verbose if the hack is intricate. I don't include additional instructions, because I'm lazy with docs, so I'd find your tool quite handy. :up:

Not sure what method you'd use, but maybe it can generate the manual by preference, either text, html, or bbcode (or all), based on the user's settings? Then I'd generate the manual with the tool, cut and paste the bbcode into the hack's thread, and save the html and text to include in the zip file. Just throwing some idea...
Reply With Quote
  #8  
Old 07-03-2005, 10:02 PM
akanevsky akanevsky is offline
 
Join Date: Apr 2005
Posts: 3,972
Благодарил(а): 0 раз(а)
Поблагодарили: 0 раз(а) в 0 сообщениях
Default

Hmm.. Ok. I, personally, never have more than two tabs open in my browser ;P

Quote:
Not sure what method you'd use, but maybe it can generate the manual by preference, either text, html, or bbcode (or all), based on the user's settings? Then I'd generate the manual with the tool, cut and paste the bbcode into the hack's thread, and save the html and text to include in the zip file. Just throwing some idea...
That's nice, but boards do not have such bbcodes as "inset div" or "horizontal line" by default. Furthermore, not all boards have a PHP tag. For example - invisionboard or phpbb ://... The idea of TEXT-OR-HTML option is useful, though
Reply With Quote
  #9  
Old 07-03-2005, 10:26 PM
tamarian tamarian is offline
 
Join Date: Oct 2001
Location: Canada
Posts: 1,205
Благодарил(а): 0 раз(а)
Поблагодарили: 0 раз(а) в 0 сообщениях
Default

Quote:
Originally Posted by Dark Visor
That's nice, but boards do not have such bbcodes as "inset div" or "horizontal line" by default. Furthermore, not all boards have a PHP tag. For example - invisionboard or phpbb ://... The idea of TEXT-OR-HTML option is useful, though
bbcode can still be done if you allow config options to define translations of bbcodes.

Is this planned as PC software or as an online tool?
Reply With Quote
  #10  
Old 07-03-2005, 11:20 PM
Princeton's Avatar
Princeton Princeton is offline
 
Join Date: Nov 2001
Location: Vineland, NJ
Posts: 6,693
Благодарил(а): 0 раз(а)
Поблагодарили: 0 раз(а) в 0 сообщениях
Default

I say go for it!
  1. text files are fine for the experienced ... but, 'html' instructions are best for the inexperienced ... Presentation is the key factor why 'html' is best for the whole
  2. if done correctly, 'html' instructions can reduce installation problems/questions posted by newbies*
* experienced coders know what to do if they run into a problem - hence, they are less likely to post 'problems' that do not exist

You should inquire with the staff here and see if they can come up with some rules/standards for the community. It will make your job easier.
Reply With Quote
Reply


Posting Rules
You may not post new threads
You may not post replies
You may not post attachments
You may not edit your posts

BB code is On
Smilies are On
[IMG] code is On
HTML code is Off

Forum Jump


All times are GMT. The time now is 04:24 AM.


Powered by vBulletin® Version 3.8.12 by vBS
Copyright ©2000 - 2025, vBulletin Solutions Inc.
X vBulletin 3.8.12 by vBS Debug Information
  • Page Generation 0.06614 seconds
  • Memory Usage 2,259KB
  • Queries Executed 13 (?)
More Information
Template Usage:
  • (1)SHOWTHREAD
  • (1)ad_footer_end
  • (1)ad_footer_start
  • (1)ad_header_end
  • (1)ad_header_logo
  • (1)ad_navbar_below
  • (1)ad_showthread_beforeqr
  • (1)ad_showthread_firstpost
  • (1)ad_showthread_firstpost_sig
  • (1)ad_showthread_firstpost_start
  • (6)bbcode_quote
  • (1)footer
  • (1)forumjump
  • (1)forumrules
  • (1)gobutton
  • (1)header
  • (1)headinclude
  • (1)navbar
  • (3)navbar_link
  • (120)option
  • (1)pagenav
  • (1)pagenav_curpage
  • (2)pagenav_pagelink
  • (10)post_thanks_box
  • (10)post_thanks_button
  • (1)post_thanks_javascript
  • (1)post_thanks_navbar_search
  • (10)post_thanks_postbit_info
  • (10)postbit
  • (10)postbit_onlinestatus
  • (10)postbit_wrapper
  • (1)spacer_close
  • (1)spacer_open
  • (1)tagbit_wrapper 

Phrase Groups Available:
  • global
  • inlinemod
  • postbit
  • posting
  • reputationlevel
  • showthread
Included Files:
  • ./showthread.php
  • ./global.php
  • ./includes/init.php
  • ./includes/class_core.php
  • ./includes/config.php
  • ./includes/functions.php
  • ./includes/class_hook.php
  • ./includes/modsystem_functions.php
  • ./includes/functions_bigthree.php
  • ./includes/class_postbit.php
  • ./includes/class_bbcode.php
  • ./includes/functions_reputation.php
  • ./includes/functions_post_thanks.php 

Hooks Called:
  • init_startup
  • init_startup_session_setup_start
  • init_startup_session_setup_complete
  • cache_permissions
  • fetch_postinfo_query
  • fetch_postinfo
  • fetch_threadinfo_query
  • fetch_threadinfo
  • fetch_foruminfo
  • style_fetch
  • cache_templates
  • global_start
  • parse_templates
  • global_setup_complete
  • showthread_start
  • showthread_getinfo
  • forumjump
  • showthread_post_start
  • showthread_query_postids
  • showthread_query
  • bbcode_fetch_tags
  • bbcode_create
  • showthread_postbit_create
  • postbit_factory
  • postbit_display_start
  • post_thanks_function_post_thanks_off_start
  • post_thanks_function_post_thanks_off_end
  • post_thanks_function_fetch_thanks_start
  • post_thanks_function_fetch_thanks_end
  • post_thanks_function_thanked_already_start
  • post_thanks_function_thanked_already_end
  • fetch_musername
  • postbit_imicons
  • bbcode_parse_start
  • bbcode_parse_complete_precache
  • bbcode_parse_complete
  • postbit_display_complete
  • post_thanks_function_can_thank_this_post_start
  • pagenav_page
  • pagenav_complete
  • tag_fetchbit_complete
  • forumrules
  • navbits
  • navbits_complete
  • showthread_complete