Yamyam: 1版をインポートしました

2018-06-28T18:37:30Z

1版をインポートしました

wiki>Mindrones: moved User:Mindrones/blender-wiki/proposal/reference to User:Mindrones/Wiki/Proposals/2009/Ref

2010-03-06T15:44:58Z

moved User:Mindrones/blender-wiki/proposal/reference to User:Mindrones/Wiki/Proposals/2009/Ref

新規ページ

= Structure =

== Actual situation ==

----

Calling a "branch" the first pseudo-folder in urls, these are the bigger branches in wiki's "Main" namespace. This is quite flat, since there aren't sub-levels other  than these (except for Scripts that is quite structured):
<pre>Tutorials (many languages)
Manual (many languages)
BSoD (many languages)
Reference (many languages)
Release notes (some languages)
Scripts
BlenderDev
Requests (many languages - should be under BlenderDev)
Hackers Guide (should be under BlenderDev)
GameEngine
GameEngineDev
Yafraydev (small)
Bf-documentation
Bf-institute
Books
Competitive analysis
Sandbox
Meta
</pre>
There are many others, but they "contain" a few pages. 

== Ton's proposal ==

----

This is what Ton proposed in bf-docboard [http://lists.blender.org/pipermail/bf-docboard/2008-December/003276.html mailing list]:
<pre>See also 2.3:
http://download.blender.org/documentation/htmlI/
http://download.blender.org/documentation/htmlII/

Her's my raw picture how to classify documents;

- Learning Blender
- general workflow tutorials (creating projects)
- feature related tutorials (i.e. texturing)

- Manual (descriptive overviews by feature)
- UI conventions
- Blender files
- Modeling
- Materials/shaders
- Game engine
- Python overview
- etc

- Reference (editors, buttons, menus, hotkeys etc)
- Installation
- User presets
- Screens/areas
- 3D window
- Ipo window
- etc

- Extending Blender
- Python
- Plugins

- Contributions
- stuff to be reviewed
- feature proposals
- case studies
- and everything that's not classifyable, or opiniated, or too personal :)
</pre>
Here we have the chapters structure in the old manual.

PART I
<pre>I. Introduction to Blender

1. Introduction
2. Installation
3. Understanding the interface
Blender's Interface Concept
Navigating in 3D Space
The vital functions
4. Your first animation in 30 + 30 minutes

II. Modelling, Materials and Lights

5. ObjectMode
6. Basic Mesh Modelling
7. Advanced Mesh Modelling
8. Meta Objects
9. Curves and Surfaces
10. Materials and Textures
11. Textures
12. Lighting
13. The World and The Universe

III. Animation

14. Animation of Undeformed Objects
15. Animation of Deformations
16. Character Animation

IV. Rendering

17. Rendering
18. Radiosity
19. Raytracing

V. Advanced Tools

20. Particles
21. Other Effects
22. Special modelling techniques
23. Soft bodies
24. Volumetric Effects
25. Sequence Editor

VI. Extending Blender

26. Python Scripting
27. Blender's Plugins System

VII. Beyond Blender

28. Yafray as an Integrated External Renderer
29. From Blender to YafRay Using YableX
30. YafRay

Glossary
</pre>
PART II
<pre>I. Reference

Blender windows - general introduction
HotKeys In-depth Reference
Windows Reference
Buttons Reference
Command Line Arguments

II. Appendices

Hotkeys Reference
Supported videocards
The Licenses
The Blender Documentation Project
Troubleshooting (-)</pre>

 

{{Meta:Bots/Python/mwclient}}

{{Meta:Bots/Python/mwclient/wiki_tree_graph}}

 

= Useful wiki extensions =

== ImageMap ==

----

[http://www.mediawiki.org/wiki/Extension:ImageMap http://www.mediawiki.org/wiki/Extension:ImageMap ]

== Captcha ==

----

*[http://www.mediawiki.org/wiki/Extension:ReCAPTCHA http://www.mediawiki.org/wiki/Extension:ReCAPTCHA] problema: si deve loggare a loro, se i loro server sono giù tu non ti logghi, e forse neanche vedi la pagina
*[http://www.mediawiki.org/wiki/Extension:VisualMathCaptcha http://www.mediawiki.org/wiki/Extension:VisualMathCaptcha]

== TagAsCategory ==

----

*[http://www.mediawiki.org/wiki/Extension:TagAsCategory http://www.mediawiki.org/wiki/Extension:TagAsCategory] <<We also recommend changing the "Categories" label to "Tags". This can be done by going to the "Special:Allmessages" page, and changing the value of "pagecategories" from "Categories" to "Tags".>> VERY USEFUL TO LET PEOPLE ADD CATEGORIES WITHOUT EDITING THE SOURCE CODE
*[http://www.mediawiki.org/wiki/Extension:ManageCategories http://www.mediawiki.org/wiki/Extension:ManageCategories] Useful to see all categories, might serve well to avoid reposting similar categories DOESN'T WORK HERE ATM

== Todo_Tasks ==

----

http://www.mediawiki.org/wiki/Extension:Todo_Tasks

== DynamicPageList ==

----

http://www.mediawiki.org/wiki/Extension:DynamicPageList

== CodeTag ==

----

http://www.mediawiki.org/wiki/Extension:GeSHiCodeTag

== Workflow ==

----

*workflow http://www.mediawiki.org/wiki/Extension:Workflow useful for release notes to wiki and for establishing tasks like draft/forapproval/final etc
*comments system http://www.mediawiki.org/wiki/Extension:WordPress_Comments useful for not using the talk page anymore, not familiar to all the users [http://www.mediawiki.org/wiki/Extension:ArticleComments http://www.mediawiki.org/wiki/Extension:ArticleComments] testing..

== Comment systems ==

----

*[http://www.mediawiki.org/wiki/Extension:ArticleComments http://www.mediawiki.org/wiki/Extension:ArticleComments] ADD COMMENTS DIRECTLY IN THE TALK PAGE, WITH AUTHOR AND DATE, THIS IS A BIG PROBLEM INDEED IN WIKI, CAUSE YOU HAVE TO PUT YOUR DETAILS BY HAND SUPER COOL :)
*[http://www.mediawiki.org/wiki/Extension:CommentPages http://www.mediawiki.org/wiki/Extension:CommentPages] I'VE TRIED THIS, IT WORKS BUT IT DEPENDS ON WHETER PEOPLE UNDERSTAND THE DIFFERENCE BETWEEN TALKPAGE AND COMMENTPAGE. Commented a line because it gives an error.[http://www.mediawiki.org/wiki/Extension:WordPress_Comments]
*[http://www.mediawiki.org/wiki/Extension:WordPress_Comments http://www.mediawiki.org/wiki/Extension:WordPress_Comments] useful for not using the talk page anymore, not familiar to all the users

== Rating and reviewing systems ==

----

*http://www.mediawiki.org/wiki/Extension:Review
*http://www.mediawiki.org/wiki/Extension:Rating 

:have to test this but this sounds useful since ii's commenting +rating+captcha

*http://www.mediawiki.org/wiki/Extension:AjaxRatingScript

:this is fine if you try this on suggested websites that use it

== Searching engines ==

----

*[http://www.mediawiki.org/wiki/Extension:SphinxSearch Sphinx]
*[http://www.mediawiki.org/wiki/Extension:Google_Custom_Search_Engine Google_Custom_Search_Engine]
*[http://www.mediawiki.org/wiki/Extension:Lucene-search Lucene] (more complex to install than a simple extensions)

== Site map ==

----

http://www.mediawiki.org/wiki/Extension:ManualSitemap useful to help searching from outside the wiki

= Blogging via mail =

== Retrieving categories and tags via python/xmlrpc ==

----

Since [http://codex.wordpress.org/XML-RPC_Support WordPress uses an XML-RPC interface], we can setup a simple script to retrieve categories and tags from a blog. This is a very simple example I made for a blog I admin:
<pre>#! /usr/bin/env python

import xmlrpclib
from pprint import pprint

server = xmlrpclib.ServerProxy("http://dirittianimali.wordpress.com/xmlrpc.php")
user = 'USERNAME'
pwd = 'PASSWORD'

print '\nCATEGORIES:\n'+'='*50
pprint(server.wp.getCategories('',user,pwd))

print '\nTAGS:\n'+'='*50
pprint(server.wp.getTags('',user,pwd))
</pre>
It outputs data as lists of dictionaries (here I print them of course) so we might use them for adding categories to wiki pages with [[#Mediawiki_API_and_mwclient|mwclient]] for example:
<pre>CATEGORIES:

[{'categoryDescription': '',
'categoryId': '13514905',
'categoryName': 'adottati',
'description': 'adottati',
'htmlUrl': 'http://dirittianimali.wordpress.com/category/adozioni/adottati/',
'parentId': '750835',
'rssUrl': 'http://dirittianimali.wordpress.com/category/adozioni/adottati/feed/'},

...

{'categoryDescription': '',
'categoryId': '13620180',
'categoryName': 'gatti da adottare',
'description': 'gatti da adottare',
'htmlUrl': 'http://dirittianimali.wordpress.com/category/adozioni/gatti-da-adottare/',
'parentId': '750835',
'rssUrl': 'http://dirittianimali.wordpress.com/category/adozioni/gatti-da-adottare/feed/'}]

TAGS:

[{'count': '1',
'html_url': 'http://dirittianimali.wordpress.com/tag/ba-bari/',
'name': '(BA) Bari',
'rss_url': 'http://dirittianimali.wordpress.com/tag/ba-bari/feed/',
'slug': 'ba-bari',
'tag_id': '14327151'},

...

{'count': '22',
'html_url': 'http://dirittianimali.wordpress.com/tag/cane/',
'name': 'cane',
'rss_url': 'http://dirittianimali.wordpress.com/tag/cane/feed/',
'slug': 'cane',
'tag_id': '19453'},

...

{'count': '9',
'html_url': 'http://dirittianimali.wordpress.com/tag/gatto/',
'name': 'gatto',
'rss_url': 'http://dirittianimali.wordpress.com/tag/gatto/feed/',
'slug': 'gatto',
'tag_id': '512148'},

...]
</pre>
Apart form the obvious benefit of having the application for managing tags already in place, we might also benefit from having RSS feeds of categories and tags. Documenters would only have to read the feed with their RSS feed aggregator of choice (Mozilla Thunderbird for example) to receive commits well categorized.

Example of a [http://dirittianimali.wordpress.com/category/adozioni/cani-da-adottare/ "cani-da-adottare" Category page] and of a [http://dirittianimali.wordpress.com/category/adozioni/cani-da-adottare/feed/ "cani-da-adottare" Category feed]. Example of a [http://dirittianimali.wordpress.com/tag/cane/ "cane" Tag page] and of a [http://dirittianimali.wordpress.com/tag/cane/feed "cane" Tag feed].

= Parsing wikitext =

From [http://pypi.python.org/pypi?%3Aaction=search&term=wiki+markup&submit=search here], [http://www.mediawiki.org/wiki/Alternative_parsers here] and [http://swik.net/wiki+parser here] we can extract a list of python scripts that let you convert from wikitext to structures/html/xml/... After a brief look I've chosen these:

*[http://code.google.com/p/wikimarkup/ wikimarkup]
*[http://pypi.python.org/pypi/mwparser mwparser]
*[http://pypi.python.org/pypi/SpiffWikiMarkup SpiffWikiMarkup]
*[http://pypi.python.org/pypi/textwiki textwiki]
*[http://pypi.python.org/pypi/mwlib mwlib] [http://code.pediapress.com/wiki/wiki/mwlib mwlib]
*[http://www.connellybarnes.com/code/python/mw2html mw2html] (depends on [http://www.connellybarnes.com/code/htmldata htmldata]
*[http://code.google.com/p/python-markdown2 python-markdown2]
*[http://pyparsing.wikispaces.com/message/view/home/2064279 pyparsing]

With some time at hand we should review them and see what can be useful for our purposes.

= See also =

*[http://wiki.blender.org/index.php/Main_Page Blender's wiki main index]

= External links =

'''discussion in mailing list'''

*[http://lists.blender.org/pipermail/bf-docboard/2008-November/003267.html doc-board thread] (1)
*[http://lists.blender.org/pipermail/bf-docboard/2008-December/003274.html doc-board thread] (2)

'''mediawiki'''

*[http://wiki.blender.org/api.php mediawiki API]
*[http://www.mediawiki.org/wiki/API:Query_-_Lists mediawiki API query list]
*[http://sourceforge.net/projects/mwclient/ mwclient] (mediawiki bot) 
*[http://www.mediawiki.org/wiki/Extension_Matrix all wiki extensions matrix]

'''wiki structure graph'''

*[http://download.blender.org/documentation/blender_wiki_081213.png big image of the wiki structure] (warning: it's 30MB)

'''wordpress xmlrpc interface'''

*[http://codex.wordpress.org/XML-RPC_Support wordpress xmlrpc support]
*[http://codex.wordpress.org/XML-RPC wordpress xml-rpc api]
*[http://docs.python.org/library/xmlrpclib.html python xmlrpclib module]

← 古い版	2018年6月28日 (木) 18:37時点における版
(相違点なし)

利用者:Mindrones/Wiki/Proposals/2009/Ref - 版の履歴

Yamyam: 1版 をインポートしました

wiki>Mindrones: moved User:Mindrones/blender-wiki/proposal/reference to User:Mindrones/Wiki/Proposals/2009/Ref

Yamyam: 1版をインポートしました